ข้ามไปยังเนื้อหา
Tellfoxคู่มือ Tellfox

รับจองจากเว็บไซต์ของคุณเอง

เว็บไซต์หรือแอปของคุณรับจองเข้า Tellfox ได้โดยตรง ผ่านระบบเดียวกับหน้าจองของ Tellfox จึงไม่มีทางจองเวลาเดียวกันซ้ำ และลูกค้าได้รับข้อความยืนยัน การเตือน และลิงก์จัดการการจองตามปกติ สร้างคีย์ที่มีสิทธิ์ customers:write และ bookings:write เซิร์ฟเวอร์ของคุณเป็นผู้เรียก API ส่วนหน้าเว็บในเบราว์เซอร์เรียกเซิร์ฟเวอร์ของคุณ (ห้ามเรียก API ด้วยคีย์จากเบราว์เซอร์)

  1. บริการ GET /v1/services แสดงบริการพร้อมราคา ความยาว และสาขา บริการจองโต๊ะ (ร้านอาหาร) จองที่หน้าจองของ Tellfox

  2. เวลาว่างในวันหนึ่ง GET /v1/availability?service_id=svc_…&date=2026-10-23 ตอบเวลาเริ่มที่ว่างแต่ละช่วง พร้อมคนที่ทำได้และราคาในเวลานั้น เพิ่ม staff_id สำหรับคนเดียว branch_id สำหรับสาขาเดียว หรือ nights สำหรับการเข้าพัก

  3. ลูกค้า POST /v1/customers พร้อมชื่อและอีเมลหรือเบอร์โทร จะได้ลูกค้า (คนที่ร้านมีอยู่แล้ว หรือคนใหม่)

  4. จอง

    Terminal window
    curl https://api.tellfox.app/v1/bookings -X POST \
      -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -H "Idempotency-Key: web-order-5521" \
      -d '{"service_id": "svc_…", "start": "2026-10-23T07:00:00Z", "customer_id": "cus_…"}'

    201 คือการจอง ถ้าเวลานั้นมีคนจองไปเมื่อสักครู่จะตอบ 409 และข้อความบอกเวลาว่างถัดไป ให้แสดงใหม่

  5. เลื่อนหรือยกเลิก POST /v1/bookings/{id}/move พร้อม start ใหม่ หรือ POST /v1/bookings/{id}/cancel ลูกค้าจะได้รับแจ้ง

คลาสใช้วิธีเดียวกัน GET /v1/sessions แสดงรอบคลาสพร้อมที่ว่าง และ POST /v1/sessions/{id}/places พร้อม customer_id เพื่อให้ที่หนึ่งที่