กุญแจ API และสัญญาข้อมูล
เลขอ้างอิงซ้ำข้ามร้าน: วาง namespace ฝั่งต้นทาง
ร้านสองแห่งอาจมี ORDER-1 เหมือนกัน หากซิงก์เข้าขอบเขตผู้ใช้เดียวกันด้วย source เดียว จะชนเหตุการณ์โดยไม่ได้ตั้งใจ พร้อมตัวอย่างตรวจสัญญาและขอบเขต MeeTang ที่ต้องระวัง
ตรวจ mapping กับ API Docs แล้วเทียบรายการที่ API Logs ยืนยันก่อนเปลี่ยน namespace ที่ใช้อยู่
1. ระบุปัญหาของสัญญาข้อมูล
ร้านสองแห่งอาจมี ORDER-1 เหมือนกัน หากซิงก์เข้าขอบเขตผู้ใช้เดียวกันด้วย source เดียว จะชนเหตุการณ์โดยไม่ได้ตั้งใจ
OpenAPI แยกคำอธิบาย operation, schema และตัวอย่างออกจากกัน จึงต้องอ่านข้อกำหนดของ field ไม่อนุมานจากตัวอย่างเดียว
OpenAPI Specification 3.1.1 ↗2. ขั้นตอนตรวจฝั่ง integration
ทำงานนี้ใน backend หรือชุดทดสอบของร้าน แยกข้อมูลจำลองจากระบบจริง และไม่เพิ่มสิทธิ์เกินงานเพื่อให้ test ผ่าน
- กำหนด source ให้คงที่และมีขอบเขตที่ทีมเข้าใจ
- แยก event ID ตามร้าน ออเดอร์และชนิดเหตุการณ์
- เก็บ mapping เดิมเพื่อให้ retry ใช้รหัสเดิมเสมอ
3. ตัวอย่างจำลองและผลที่ควรตรวจ
ตัวระบุ ยอด และเหตุการณ์ต่อไปเป็นตัวอย่าง ไม่ใช่ credentials หรือข้อมูลบัญชีที่นำไปใช้จริงได้
4. สิ่งที่ห้ามอนุมานเพิ่ม
External Finance ตรวจซ้ำด้วยผู้ใช้ token + source + external_id ร่วมกันระหว่าง revenue/cost/batch แต่ไม่รับรอง atomic idempotency ทุกสถานการณ์ ต้องควบคุมคำขอเหตุการณ์เดียวไม่ให้แข่งกัน
5. จุดตรวจใน MeeTang
ตรวจ mapping กับ API Docs แล้วเทียบรายการที่ API Logs ยืนยันก่อนเปลี่ยน namespace ที่ใช้อยู่
พฤติกรรมผลิตภัณฑ์ในบทความตรวจจากสัญญาและ source ของ repository วันที่ 27 กันยายน 2026 ไม่ใช่ผลทดสอบ deployment จริง จึงต้องตรวจสัญญาที่ใช้งานก่อนเปิดส่งข้อมูล
API Docs (ต้องเข้าสู่ระบบ) ↗API Logs (ต้องเข้าสู่ระบบ) ↗แหล่งอ้างอิงและขอบเขตเนื้อหา
แหล่งต่อไปนี้อธิบายหลักการทั่วไป ส่วนขั้นตอนของ MeeTang ตรวจจากฟีเจอร์ในระบบ ณ วันที่อัปเดต ตัวเลขในตัวอย่างไม่ใช่ข้อมูลผู้ใช้งานจริง
- OpenAPI Specification 3.1.1 — โครงสร้าง operation, schema, required และตัวอย่าง
จัดทำด้วย AI ช่วยเรียบเรียงและตรวจเทียบกับโค้ด ไม่ใช่คำแนะนำภาษีหรือการรับรองผลทางบัญชี เงื่อนไขฟีเจอร์และโควตาขึ้นกับแพ็กเกจและสิทธิ์ที่ได้รับ
เริ่มจากงานที่คุณกำลังทำ
ตรวจ mapping กับ API Docs แล้วเทียบรายการที่ API Logs ยืนยันก่อนเปลี่ยน namespace ที่ใช้อยู่
เปิดเอกสาร API (ต้องเข้าสู่ระบบ) →หน้าจัดการข้อมูลต้องเข้าสู่ระบบก่อนใช้งาน