เชื่อมเว็บทัวร์เข้ากับระบบ EasyTourAgent

ETA API ใช้สำหรับให้เว็บไซต์ลูกค้าดึง catalog ทัวร์จากระบบ EasyTourAgent และสร้าง booking กลับเข้าระบบกลางได้ โดยแยก tenant, visibility, ราคา และสิทธิ์การใช้งานตาม key ของแต่ละเจ้า.

1. สร้าง tenant ในหน้า admin และตั้งสถานะเป็น trial หรือ active.
2. ออก Widget token สำหรับเว็บที่ต้องการฝังหน้าค้นหาทัวร์.
3. ออก Server API key พร้อม scope ที่ต้องใช้ เช่น catalog:read และ booking:create.
4. ทดสอบดึง catalog, tour detail, departures และสร้าง booking ตัวอย่าง.
5. ล็อก allowed origins, ตรวจราคา/รอบเดินทาง และตั้ง monitoring ก่อนเปิดจริง.

curl "https://easytouragent.com/api/tenant/catalog?limit=5&continent=asia" \
  -H "Authorization: Bearer eta_live_xxx"

ถ้าลูกค้ายังไม่มีทีม dev ให้เริ่มจาก iframe ก่อน เพราะใช้งานเร็วและปลอดภัยกว่า. ถ้าต้องการ UI ของตัวเอง ให้เรียก widget API ด้วย token ที่ล็อก origin แล้ว.

<iframe
  src="https://easytouragent.com/embed/tours?token=eta_widget_xxx"
  width="100%"
  height="720"
  style="border:0"
></iframe>

GET https://easytouragent.com/api/widget/tours?token=eta_widget_xxx&limit=12&continent=asia&q=japan

Server API เหมาะกับเว็บลูกค้าที่มี frontend/SEO ของตัวเอง และต้องการควบคุมหน้ารายละเอียดเองทั้งหมด.

curl "https://easytouragent.com/api/tenant/catalog?limit=24&continent=europe" \
  -H "Authorization: Bearer eta_live_xxx"

curl "https://easytouragent.com/api/tenant/tours/japan-autumn-5d" \
  -H "Authorization: Bearer eta_live_xxx"

curl "https://easytouragent.com/api/tenant/tours/japan-autumn-5d/departures" \
  -H "Authorization: Bearer eta_live_xxx"

ใช้ gateway endpoint สำหรับเว็บลูกข่ายที่ยิงเช็กที่นั่งถี่ ๆ หลายเว็บไซต์พร้อมกัน. Availability รันบน Node.js runtime พร้อม SWR 60 วินาทีและ Redis cache; Hold เป็น no-cache และเรียก RPC ที่ล็อกแถว departure ด้วย SELECT ... FOR UPDATE.

curl "https://easytouragent.com/api/gateway/tours/japan-autumn-5d/availability?departure_date=2026-10-12" \
  -H "Authorization: Bearer eta_live_xxx"

curl -X POST "https://easytouragent.com/api/gateway/tours/japan-autumn-5d/hold" \
  -H "Authorization: Bearer eta_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "departure_date": "2026-10-12",
    "quantity": 2,
    "hold_minutes": 10,
    "external_ref": "WEB-ORDER-1001",
    "customer": {
      "name": "Somchai Demo",
      "phone": "0812345678",
      "email": "somchai@example.com"
    }
  }'

ระบบสร้างรายการจองจะตรวจสิทธิ์การมองเห็นทัวร์ ตรวจรอบเดินทางถ้าระบุวันที่ คำนวณราคาตามลูกค้า และสร้างลีดสถานะรอชำระเงิน

curl -X POST "https://easytouragent.com/api/tenant/bookings" \
  -H "Authorization: Bearer eta_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tour_id": "japan-autumn-5d",
    "departure_date": "2026-10-12",
    "name": "Somchai Demo",
    "phone": "0812345678",
    "email": "somchai@example.com",
    "adults": 2,
    "payment_method": "reserve",
    "external_ref": "WEB-ORDER-1001"
  }'

{
  "ok": true,
  "booking_ref": "ETA-12345",
  "lead_id": 12345,
  "tenant": { "id": "uuid", "slug": "happy-tour" },
  "total_price": 59800,
  "deposit_total": 20000,
  "status": "pending_payment"
}

{
  "event_type": "booking.created",
  "booking_ref": "ETA-12345",
  "lead_id": 12345,
  "source": "tenant_api",
  "external_ref": "WEB-ORDER-1001",
  "customer": {
    "name": "Somchai Demo",
    "phone": "0812345678",
    "email": "somchai@example.com"
  },
  "departure_date": "2026-10-12",
  "total_price": 59800
}