API

API ที่มีเอกสารสำหรับการเชื่อมต่อ

เ⁠ว็⁠บ⁠ไ⁠ซ⁠ต์ แ⁠อ⁠ปสั่งอาหาร หรือบริการเ⁠ด⁠ลิ⁠เ⁠ว⁠อ⁠รี ทำงานผ่านคี⁠ย์ของร้าน คี⁠ย์ใช้ได้กับร้านเดียว ยกเลิกได้ทันที และเข้าถึงข้อมูลของร้านอื่นไม่ได้ ซึ่งเป็นผลจากโครงสร้างของระบบ ไม่ใช่การตรวจสอบแยกต่างหาก

Back office: website section — storefront with dish photos from the till menu

การเชื่อมต่อทำอะไรได้บ้าง

📋

เ⁠ม⁠นูและสถานะพร้อมขาย

หน้าร้านได้รับหมวดหมู่ เ⁠ม⁠นู ราคา ตัวเลือกเพิ่ม และรูปภาพ โดยตัดรายการที่หยุดขายออกแล้ว และมีสถานะ «ร้านไม่รับอ⁠อ⁠เ⁠ด⁠อ⁠ร์ในขณะนี้»

🧾

รับอ⁠อ⁠เ⁠ด⁠อ⁠ร์

สร้างอ⁠อ⁠เ⁠ด⁠อ⁠ร์ได้ด้วยคำขอเดียวและได้เลขอ⁠อ⁠เ⁠ด⁠อ⁠ร์ ส่งคำขอเดิมซ้ำไม่เกิดอ⁠อ⁠เ⁠ด⁠อ⁠ร์ที่สอง

✏️

แก้ไขและยกเลิก

ระหว่างที่ร้านยังไม่รับอ⁠อ⁠เ⁠ด⁠อ⁠ร์ ต้นทางแก้รายการหรือยกเลิกอ⁠อ⁠เ⁠ด⁠อ⁠ร์ได้

🎟

ตรวจโค้ดส่วนลด

คูปองตรวจที่ฝั่ง POSitive ส่วนลดบนหน้าร้านออนไลน์และที่แ⁠ค⁠ช⁠เ⁠ชี⁠ย⁠ร์จึงตรงกัน

💳

แจ้งการชำระเงิน

การชำระเงินที่รับฝั่งหน้าร้านออนไลน์ผูกกับวิธีชำระเงินของร้าน เงินจึงเข้าบัญชีที่ถูกต้อง

↩️

ส่งสถานะกลับ

รับแล้ว กำลังทำ ส่งให้ไรเดอร์แล้ว เสร็จสิ้น การแจ้งเตือนส่งถึงต้นทางและลงลายเซ็นด้วยความลับที่ใช้ร่วมกัน

สเปกไม่เผยแพร่สาธารณะ ที่อยู่ของเมธอด รายการฟิลด์ รหัสข้อผิดพลาด และตัวอย่างคำขอ ให้พร้อมกับคี⁠ย์ แก่ร้าน นักพัฒนาของร้าน หรือพาร์ทเนอร์ เหตุผลง่าย ๆ คือข้อกำหนดที่เปิดไว้บนเ⁠ว็⁠บ⁠ไ⁠ซ⁠ต์ช่วยคนที่หาช่องโหว่ในการเชื่อมต่อของคนอื่นมากกว่าช่วยผู้เชื่อมต่อระบบ ขอคำอธิบายได้ด้วยคำขอเดียว และเราตอบภายในวันเดียวกัน

ข้อกำหนดรับประกันอะไร

🔁

Idempotency

ส่งซ้ำด้วยคี⁠ย์ของรายการเดิมไม่เกิดอ⁠อ⁠เ⁠ด⁠อ⁠ร์ที่สอง ป้องกันการกดซ้ำและสัญญาณหลุด

🔐

ลายเซ็นและคี⁠ย์

คี⁠ย์ใช้ได้กับหนึ่งร้านและยกเลิกได้ทันที ความลับเก็บเป็นแฮชและกู้คืนไม่ได้ แม้แต่เราเอง คี⁠ย์อยู่บนเซิร์ฟเวอร์ของพาร์ทเนอร์ ไม่ใช่ในเบราว์เซอร์ของลูกค้า

🧾

ข้อผิดพลาดที่อธิบายชัด

คำตอบบอกว่ารายการไหนไม่ผ่านและเพราะอะไร แทนที่จะเป็นแค่ «400 Bad Request»

🛑

รายการที่หมดเป็นปัจจุบัน

เ⁠ม⁠นูส่งไปโดยไม่มีรายการที่หยุดขาย รายการที่ปิดขายที่แ⁠ค⁠ช⁠เ⁠ชี⁠ย⁠ร์หายจากเ⁠ว็⁠บ⁠ไ⁠ซ⁠ต์ทันที

↩️

ช่องทางย้อนกลับ

สถานะอ⁠อ⁠เ⁠ด⁠อ⁠ร์ส่งกลับถึงต้นทาง: รับแล้ว กำลังทำ ส่งให้ไรเดอร์แล้ว เสร็จสิ้น

🧪

แซนด์บ็อกซ์

ร้านทดสอบพร้อมคี⁠ย์แยก สร้างและทดสอบการเชื่อมต่อได้โดยไม่แตะข้อมูลจริง

ต้องการคี⁠ย์หรือข้อกำหนดไหม

เราส่งคำอธิบายพร้อมฟิลด์และตัวอย่าง เปิดแซนด์บ็อกซ์ และตอบคำถามเรื่องการเชื่อมต่อ