ส่วนที่ 8 จาก 12

การเชื่อมต่อและ API

เชื่อมต่อ Buqq กับ POS หรือเครื่องมือที่กำหนดเองผ่าน REST API ภายนอก

ส่วนการเชื่อมต่อให้บริการ REST API ภายนอกสำหรับสร้างการเชื่อมต่อแบบกำหนดเองกับระบบ POS หรือเครื่องมืออื่นๆ ของคุณ เข้าถึงได้จาก แดชบอร์ด → การเชื่อมต่อ

เอกสารอ้างอิง API ฉบับสมบูรณ์ — รูปแบบ endpoint รายละเอียดการยืนยันตัวตน และตัวอย่างการใช้งาน — สามารถดูได้ที่ buqq.online/api-docs
การแจ้งเตือนการจองผ่าน Telegram ตั้งค่าได้ใน ตั้งค่า → การแจ้งเตือน ดูขั้นตอนการตั้งค่าได้ในส่วน ตั้งค่า ของคู่มือนี้

Merchant ID#

Merchant ID คือตัวระบุเฉพาะสำหรับบัญชีของคุณภายในแพลตฟอร์ม Buqq ซึ่งจะแสดงบนหน้าการเชื่อมต่อ และจำเป็นเมื่อติดต่อฝ่ายสนับสนุนหรือใช้ API endpoint บางรายการ

คีย์ API#

API ภายนอกของ Buqq ช่วยให้คุณอ่านข้อมูลช่วงเวลาที่ว่าง สร้างการจอง และอัปเดตสถานะการจองจากระบบของคุณเอง การเข้าถึง API ต้องใช้คีย์ API ที่ผูกกับบัญชีร้านค้าของคุณ

การสร้างคีย์

  1. ใน แดชบอร์ด → การเชื่อมต่อ เลื่อนลงไปที่ "คีย์ API"
  2. คลิก "สร้างคีย์ API"
  3. คัดลอกคีย์และเก็บไว้ใน environment variables หรือ secrets manager ของคุณ
ปฏิบัติต่อคีย์ API ของคุณเหมือนรหัสผ่าน — อย่าแชร์หรือ commit ลงใน version control หากคุณสงสัยว่าคีย์ถูกเปิดเผย ให้เพิกถอนทันทีและสร้างคีย์ใหม่

การแสดงคีย์ปัจจุบัน

หากคุณต้องการดูคีย์ที่มีอยู่ ให้คลิก แสดง — คีย์ทั้งหมดจะปรากฏเพื่อให้คุณคัดลอกได้อีกครั้ง

การหมุนเวียนคีย์

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

การเพิกถอนคีย์

การเพิกถอนจะลบคีย์ปัจจุบันโดยไม่ออกคีย์ใหม่ การเรียก API จะล้มเหลวจนกว่าคุณจะสร้างคีย์ใหม่ ใช้การเพิกถอนหากคุณสงสัยว่าคีย์ถูกเปิดเผย

ตัวอย่าง cURL#

หน้าการเชื่อมต่อแสดงตัวอย่าง cURL ที่พร้อมใช้งานสำหรับการดำเนินการ API ที่พบบ่อยที่สุด แทนที่ YOUR_API_KEY ด้วยคีย์จริงของคุณเพื่อทดสอบได้ทันที

ตัวอย่าง — ตรวจสอบช่วงเวลาที่ว่าง

curl https://buqq.online/api/external/v1/availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G -d "date=2025-08-15" -d "party_size=2"

หมายเหตุ POS#

หากคุณกำลังเชื่อมต่อ Buqq กับระบบ POS API ภายนอกรองรับการอ่านข้อมูลการจองที่ยืนยันแล้วของวันนี้ และการอัปเดตสถานะ (เช่น ทำเครื่องหมายการจองว่าเช็คอินแล้วหรือยกเลิก) จากระบบ POS ของคุณ กรุณาศึกษาเอกสารของผู้ให้บริการ POS สำหรับขั้นตอนการเชื่อมต่อเฉพาะ และดู เอกสาร API สำหรับรายละเอียด endpoint

GET /api/external/v1/availability
ส่งคืนช่วงเวลาที่ว่างสำหรับวันที่และจำนวนคนที่กำหนด
GET /api/external/v1/bookings
แสดงรายการการจองสำหรับร้านอาหารของคุณ กรองตามวันที่ได้
POST /api/external/v1/bookings
สร้างการจองใหม่ผ่านโปรแกรม
PATCH /api/external/v1/bookings/{id}/status
อัปเดตสถานะการจอง (confirmed, checked_in, cancelled, no_show)