การยืนยันตัวตนและ API Keys

พื้นฐานของ API key

ThailandAPI ใช้ API key ที่ผูกกับ subscription

การทำงานของ key

• key จะผูกกับ subscription ไม่ได้ผูกกับผู้ใช้คนเดียว
• subscription เดียวกันสามารถมีได้หลาย key สำหรับหลาย environment หรือหลาย service
• การคิดเครดิตและการจำกัดอัตราการเรียกใช้งานจะอิงจาก subscription ของ key นั้น

วิธีส่ง key

ให้ส่งผ่าน header X-API-Key ทุกครั้ง

GET /your-endpoint HTTP/1.1
Host: api-slug.your-domain.example
X-API-Key: tap_live_xxxxxxxxx

แนวทางความปลอดภัย

• อย่าเปิดเผย production key ใน frontend bundle
• ควร rotate key เมื่อมีการเปลี่ยนทีมงานหรือมีการแชร์ credential กว้างเกินไป
• แยก key ระหว่าง local, staging และ production

การตรวจสอบปัญหา

• 401 มักหมายถึง key ไม่ถูกต้อง ถูก revoke หรือไม่ได้ส่งมา
• 429 มักหมายถึง subscription ชน rate limit หรือ quota limit
• คุณสามารถตรวจสอบ plan และเครดิตคงเหลือได้จากหน้าการใช้งานและ billing