Guides
ขีดจำกัดอัตราคำขอและข้อผิดพลาด
Public API per-account rate limits, error response format, status codes and caching guidance.
On this page
Rate limits#
หมายเหตุ
API สาธารณะและ MCP ที่ยืนยันตัวตนแล้วใช้โควตารายชั่วโมงร่วมกันต่อพาร์ตเนอร์ (ค่าเริ่มต้น 20,000) การเพิ่มหรือหมุนเวียนคีย์ไม่ได้เพิ่มโควตา
กรอบเวลา 3,600 วินาทีเริ่มนับตั้งแต่คำขอแรก และมีขีดจำกัดต่อนาทีด้วย โควตานับจากจำนวนการเรียก ไม่ใช่ MB ที่รับส่ง การตั้งค่าการดำเนินงานอาจเปลี่ยนโควตาได้
ชุดคำขอ MCP รับได้สูงสุด 100 ข้อความ และนับแต่ละข้อความเป็นหนึ่งการเรียก ชุดที่เกินโควตาที่มีจะได้ผลลัพธ์ 429 ก่อนดำเนินการ
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
เฮดเดอร์เหล่านี้แสดงขีดจำกัดรายชั่วโมง จำนวนการเรียกที่เหลือ และเวลารีเซ็ต (วินาที Unix) เมื่อใช้ครบโควตารายชั่วโมงจะคืนค่า HTTP 429 พร้อม Retry-After เป็นวินาที การเรียกที่ถูกปฏิเสธจากขีดจำกัดต่อนาทีจะไม่นับรวมในโควตารายชั่วโมง
โดยค่าเริ่มต้น แต่ละบัญชีพาร์ตเนอร์ส่งคำขอได้ 600 ครั้งต่อนาที หากเกินจะได้รับ 429 rate_limited.
ทิป
Status codes#
| HTTP | ความหมาย |
|---|---|
| 200 | สำเร็จ |
| 400 | พารามิเตอร์ไม่ถูกต้อง |
| 401 invalid_api_key | คีย์หายไป ไม่ถูกต้อง หรือถูกเพิกถอน |
| 404 | ไม่รู้จัก ID ของ eSIM |
| 429 rate_limited | เกินขีดจำกัดอัตราคำขอ |
Error format#
// 401 — missing, invalid or revoked key
{
"error": "invalid_api_key",
"message": "Missing or invalid API key. Create one at https://www.esimoa.com/developers/dashboard"
}
// 429 — too many requests for this key
{ "error": "rate_limited", "message": "Rate limit exceeded (600 requests per minute)." }
// 400 — invalid parameters / 404 — unknown eSIM id
{ "statusCode": 404, "message": "eSIM not found", "error": "Not Found" }Caching#
ราคาเปลี่ยนบ่อย — แคชผลการค้นหาไม่เกินไม่กี่นาที