URL Callback / Webhook
ปฏิวัติวงการ "คนรอ"

ในบทเรียนที่แล้ว เราใช้ API ปกติ (REST API) เพื่อดึงข้อมูลสภาพอากาศ ซึ่งเซิร์ฟเวอร์สามารถตอบได้ทันทีในเสี้ยววินาที แต่ในโลกแห่งความเป็นจริง มีหลายงานที่ "ไม่สามารถเสร็จได้ในทันที" ตัวอย่างเช่น:

• การให้ AI ประมวลผลวิดีโอความยาว 1 ชั่วโมง (อาจใช้เวลา 20 นาที)
• การสั่งพิมพ์เสื้อยืดจากโรงงาน (อาจใช้เวลา 3 วัน)
• การตัดบัตรเครดิตที่ต้องรอให้ธนาคารส่ง OTP เข้ามือถือลูกค้า (อาจใช้เวลา 1-5 นาที)

ลองคิดดูว่าถ้าแอปคุณมีผู้ใช้งาน 100,000 คนพร้อมกัน เซิร์ฟเวอร์ธนาคารจะต้องรับคำขอ (Request) เป็นล้านๆ ครั้งต่อนาที นี่คือการกระทำที่สิ้นเปลืองทรัพยากร เปลืองแบนด์วิดท์ และทำให้เซิร์ฟเวอร์พัง (Crash) ได้ง่ายที่สุดเลย!

เพื่อแก้ปัญหานี้ วงการพัฒนาซอฟต์แวร์จึงสร้างคอนเซปต์ใหม่ที่เรียกว่า Webhook (เว็บฮุค) หรือ URL Callback ขึ้นมา คอนเซปต์ของมันคือคำพังเพยที่ว่า "Don't call us, we'll call you." (ไม่ต้องโทรมาถามหรอก เดี๋ยวทำเสร็จแล้วเราจะโทรกลับไปเอง)

มันทำงานอย่างไร?
คุณแค่สร้าง "ช่องทางรับข่าวสาร" ขึ้นมา 1 ช่องทางบนเซิร์ฟเวอร์ของคุณเอง (สร้าง Endpoint API ของคุณขึ้นมา เช่น https://your-shop.com/api/payment-success) และเมื่อคุณส่งคำสั่งให้ธนาคารตัดเงิน คุณก็ "แนบ" ลิงก์นี้ไปด้วย บอกธนาคารว่า:

ผลลัพธ์คือ ระบบของคุณจะได้ไปทำงานอย่างอื่นอย่างสบายใจ (ไม่ต้องทำลูปถามย้ำๆ) และเมื่อธนาคารตัดเงินสำเร็จ เซิร์ฟเวอร์ของธนาคารจะเปลี่ยนร่างเป็น Client ชั่วคราว แล้วยิงข้อมูล (POST Request) มาที่ลิงก์ของคุณทันที!

เวลาที่ระบบภายนอก (เช่น ธนาคาร, LINE, Facebook) ยิง Webhook กลับมาหาเซิร์ฟเวอร์เรา เขาจะแพ็คข้อมูลสถานะล่าสุดมาให้ในรูปแบบ JSON เสมอ เพื่อให้ระบบของเราเอาไปอัปเดตฐานข้อมูลต่อได้ ตัวอย่างเช่น ถ้านี่คือ Webhook จากบริษัทชำระเงิน Stripe เมื่อมีการจ่ายเงินสำเร็จ:

POST Request -> https://your-shop.com/api/webhook
{
  "id": "evt_1MqwQ4LkdIwHu7ix",
  "object": "event",
  "type": "payment_intent.succeeded",
  "created": 1679012345,
  "data": {
    "object": {
      "id": "pi_1Mqw...",
      "amount": 250000,
      "currency": "thb",
      "status": "succeeded",
      "customer_email": "[email protected]"
    }
  }
}

เมื่อโค้ดฝั่งหลังบ้านของคุณได้รับก้อนข้อมูลนี้ มันก็จะอ่านค่า type === "payment_intent.succeeded"และรู้ทันทีว่าการสั่งซื้อเสร็จสมบูรณ์ ระบบของคุณก็จะสามารถส่งอีเมลใบเสร็จ หรือเปิดคอร์สเรียนให้ลูกค้าได้เลยโดยอัตโนมัติ

แม้ Webhook จะยอดเยี่ยมและประหยัดทรัพยากรมาก แต่มันก็มาพร้อมกับ "ความรับผิดชอบอันใหญ่ยิ่ง" ที่โปรแกรมเมอร์ต้องระวังให้ดี:

ในมุมของโปรแกรมเมอร์ การใช้ Webhook หมายความว่าเราต้อง "สร้าง API" ขึ้นมาเอง นี่คือตัวอย่างโค้ด JavaScript หลังบ้าน (Node.js/Express) ที่รอรับข้อมูลเมื่อมีคนโอนเงิน:

server.js
// 1. สร้าง Endpoint API ของเราเตรียมไว้ให้เขามาทัก (POST)
app.post('/api/webhook/payment', (req, res) => {
  
  // 2. รับข้อมูล JSON ที่ระบบธนาคารแพ็คส่งมาให้
  const event = req.body;

  // 3. เช็คว่ามันคือเหตุการณ์ (Event) อะไร?
  if (event.type === 'payment.success') {
    const amount = event.data.amount;
    const user_id = event.data.user_id;
    
    // 4. เขียนโค้ดอัปเดตฐานข้อมูลของเรา
    console.log(`เย้! ลูกค้าหมายเลข ${user_id} จ่ายเงินมา ${amount} บาทแล้ว`);
    database.updateUserStatus(user_id, 'PAID');
  }

  // 5. **สำคัญมาก** ต้องตอบกลับ 200 OK ให้ธนาคารรู้ว่า "เราได้รับข้อความแล้วนะ ไม่ต้องส่งซ้ำ!"
  res.status(200).send('Webhook received successfully');
});