กุญแจ API และสัญญาข้อมูล

ส่งเลขบัญชีผ่าน API: ทำไมชนิด string จึงสำคัญ

เลขบัญชีเป็นตัวระบุไม่ใช่จำนวนเงิน การแปลงเป็นตัวเลขทำให้ศูนย์นำหน้าหาย และชื่อ bank_account_id ของ API สองกลุ่มยังหมายถึงคนละอย่าง พร้อมตัวอย่างตรวจสัญญาและขอบเขต MeeTang ที่ต้องระวัง

โดย MeeTang Teamบทความประจำวันที่ เผยแพร่ อัปเดต อ่านประมาณ 4 นาที
สิ่งที่จะได้จากบทความนี้

ตรวจบัญชีใน Bank Accounts และเทียบตัวอย่าง field ใน API Docs ก่อน map ข้อมูล

1. ระบุปัญหาของสัญญาข้อมูล

เลขบัญชีเป็นตัวระบุไม่ใช่จำนวนเงิน การแปลงเป็นตัวเลขทำให้ศูนย์นำหน้าหาย และชื่อ bank_account_id ของ API สองกลุ่มยังหมายถึงคนละอย่าง

RFC 8259 แยก string, number และ null เป็นคนละชนิด การ parse ได้จึงไม่แปลว่าชนิดข้อมูลตรงสัญญาธุรกิจ

RFC 8259: JSON ↗

2. ขั้นตอนตรวจฝั่ง integration

ทำงานนี้ใน backend หรือชุดทดสอบของร้าน แยกข้อมูลจำลองจากระบบจริง และไม่เพิ่มสิทธิ์เกินงานเพื่อให้ test ผ่าน

  • อ่าน GET /external/banks แล้วเก็บ account_number เป็น string
  • ส่ง bank_account_id เป็นเลขบัญชี string สำหรับ /external/*
  • สำหรับ /transactions ใช้ bank_account_number เมื่อมีเลขบัญชี ไม่ส่งเลขนั้นเป็น database ID

3. ตัวอย่างจำลองและผลที่ควรตรวจ

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

4. สิ่งที่ห้ามอนุมานเพิ่ม

batch ภายนอกใช้ bank_account_id; ตามสัญญาปัจจุบันอย่าพึ่ง alias bank_account_number ใน batch และอย่าใช้ ID จากคนละพื้นที่

5. จุดตรวจใน MeeTang

ตรวจบัญชีใน Bank Accounts และเทียบตัวอย่าง field ใน API Docs ก่อน map ข้อมูล

พฤติกรรมผลิตภัณฑ์ในบทความตรวจจากสัญญาและ source ของ repository วันที่ 27 กันยายน 2026 ไม่ใช่ผลทดสอบ deployment จริง จึงต้องตรวจสัญญาที่ใช้งานก่อนเปิดส่งข้อมูล

API Docs (ต้องเข้าสู่ระบบ) ↗Bank Accounts (ต้องเข้าสู่ระบบ) ↗

แหล่งอ้างอิงและขอบเขตเนื้อหา

แหล่งต่อไปนี้อธิบายหลักการทั่วไป ส่วนขั้นตอนของ MeeTang ตรวจจากฟีเจอร์ในระบบ ณ วันที่อัปเดต ตัวเลขในตัวอย่างไม่ใช่ข้อมูลผู้ใช้งานจริง

  • RFC 8259: JSON — ชนิด string, number, null และข้อจำกัดความแม่นยำในการรับส่ง JSON

จัดทำด้วย AI ช่วยเรียบเรียงและตรวจเทียบกับโค้ด ไม่ใช่คำแนะนำภาษีหรือการรับรองผลทางบัญชี เงื่อนไขฟีเจอร์และโควตาขึ้นกับแพ็กเกจและสิทธิ์ที่ได้รับ

เริ่มจากงานที่คุณกำลังทำ

ตรวจบัญชีใน Bank Accounts และเทียบตัวอย่าง field ใน API Docs ก่อน map ข้อมูล

เปิดเอกสาร API (ต้องเข้าสู่ระบบ) →

หน้าจัดการข้อมูลต้องเข้าสู่ระบบก่อนใช้งาน