ขีดจำกัดการเรียกใช้

ขีดจำกัดจำนวนคำขอต่อช่วงเวลา และ header ที่บอกโควตาคงเหลือ

สร้างจาก public-api.md โดยอัตโนมัติเวอร์ชัน 1.2.0ปรับปรุงล่าสุด 2026-09-20

#ขีดจำกัดการเรียกใช้ (Rate Limits)

การจำกัดอัตราการเรียกใช้คิดเป็นราย ร้านค้า บังคับที่ API gateway ด้วยหน้าต่างเลื่อน 1 นาที และ ไม่มีการจำกัดแยกราย endpoint

โควตา	ขีดจำกัด (ค่าเริ่มต้น)	ครอบคลุม
Payment API	60 คำขอ/นาที	ทั้งหมดของ `/v1/payments/*` รวมกัน
Merchant Reports API	60 คำขอ/นาที	ทั้งหมดของ `/v1/merchant-reports/*` รวมกัน
ตัวช่วยของ sandbox	300 คำขอ/นาที ต่อ IP	`/sandbox/*` (จำกัดที่ขอบ ไม่ได้คิดรายร้านค้า)

โควตาสองก้อนของร้านค้าเป็นอิสระต่อกัน การดึงรายงานจึงไม่กินโควตาของการรับ-จ่ายเงิน ค่าขีดจำกัดปรับได้รายการติดตั้ง (RATE_LIMIT_REQUESTS_PER_MINUTE, REPORTS_RATE_LIMIT_PER_MINUTE) ค่าข้างต้นคือค่าที่ใช้อยู่จริง — โปรดยืนยันขีดจำกัด ตามสัญญาของคุณกับฝ่ายสนับสนุน

ทุก response ที่ผ่านการยืนยันตัวตนจะมี header ของขีดจำกัดกลับมาด้วย:

Header	คำอธิบาย
`X-RateLimit-Limit`	จำนวนคำขอสูงสุดต่อหนึ่งหน้าต่างเวลา
`X-RateLimit-Remaining`	จำนวนคำขอที่เหลือในหน้าต่างเวลานี้
`X-RateLimit-Reset`	เวลา Unix ที่หน้าต่างเวลาจะรีเซ็ต

เมื่อเกินขีดจำกัดจะได้ 429 พร้อม Retry-After (หน่วยวินาที):

json

{
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "Rate limit exceeded. Please retry later.",
  "retry_after": 37
}

{
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "Rate limit exceeded. Please retry later.",
  "retry_after": 37
}

หากที่เก็บข้อมูลของตัวจำกัดอัตราใช้งานไม่ได้ ระบบจะปล่อยคำขอผ่านแทนที่จะปฏิเสธ การที่ไม่มีชุด header X-RateLimit-* จึงไม่ใช่ข้อผิดพลาด

หน้านี้แปลจากเอกสารต้นฉบับภาษาอังกฤษ ส่วนที่เป็นค่าทางเทคนิค — path, ชื่อฟิลด์, header, รหัสข้อผิดพลาด และชื่อคอลัมน์ในไฟล์ส่งออก — คงไว้เป็นภาษาอังกฤษตามที่ระบบใช้จริง