รหัสข้อผิดพลาดและแนวทางการรีทราย

โครงสร้างของเรสปอนส์ข้อผิดพลาด

{
  "error": {
    "code": "invalid_parameter",
    "message": "store_id is required",
    "param": "store_id",
    "request_id": "req_01HV6N..."
  }
}

request_id จำเป็นต้องใช้เมื่อติดต่อฝ่ายสนับสนุน กรุณาใส่ไว้ในบันทึกข้อผิดพลาดเสมอ

รายการรหัสสถานะ HTTP

รหัสข้อผิดพลาดหลัก

แนวทางการรีทราย

เงื่อนไขที่รีทรายได้

• สถานะ HTTP เป็น 429 หรือ 5xx
• เน็ตเวิร์กไทม์เอาต์・ข้อผิดพลาดการเชื่อมต่อ
• กรณี POST ให้ตั้ง Idempotency-Key เสมอ (เพื่อป้องกันการสร้างซ้ำ)

ระยะห่างการรีทราย (exponential backoff + jitter)

function retryDelay(attempt) {
  // 1, 2, 4, 8, 16 วินาที (สูงสุด 32 วินาที)
  const base = Math.min(Math.pow(2, attempt), 32);
  // jitter ±25% เพื่อเลี่ยงการเข้าถึงแบบกระจุกตัว
  const jitter = base * (Math.random() * 0.5 - 0.25);
  return (base + jitter) * 1000;
}

จำนวนรีทรายสูงสุด

• API ทั่วไป：สูงสุด 5 ครั้ง
• การประมวลผลแบบแบตช์：สูงสุด 10 ครั้ง
• เกิดจากการกระทำของผู้ใช้：สูงสุด 2 ครั้ง (ไม่ให้รอนานเกินไป)

กรณี 429 ให้ให้ความสำคัญกับเฮดเดอร์ Retry-After

HTTP/1.1 429 Too Many Requests
Retry-After: 30

→ รอ 30 วินาทีแล้วค่อยลองใหม่

กรณีที่ห้ามรีทราย

• 4xx (ยกเว้น 429)：เพราะปัญหาอยู่ที่ตัวรีเควสต์เอง ลองกี่ครั้งก็เหมือนเดิม
• กรณี POST/PUT ที่ไม่ได้แนบ Idempotency-Key：เสี่ยงต่อการสร้างซ้ำ

คู่มือที่เกี่ยวข้อง

• พื้นฐานของรีเควสต์และเรสปอนส์
• การจำกัดอัตราการเรียกและการควบคุมปริมาณ
• กลับไปที่ศูนย์ช่วยเหลือสำหรับนักพัฒนา