ข้อผิดพลาดและโควตา (Errors & Rate Limits)

Fotobots มีระบบควบคุมปริมาณการเรียกใช้งาน (Rate Limiting) เพื่อรักษาเสถียรภาพของระบบ

---

รูปแบบ Response เมื่อเกิดข้อผิดพลาด

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "albumId is required and must be a valid UUID",
    "details": {
      "field": "albumId"
    }
  }
}

รหัสข้อผิดพลาดหลัก (Error Codes)

HTTP Status	Error Code	ความหมายและการแก้ไข
400	BAD_REQUEST	ข้อมูลที่ส่งมาไม่ถูกต้องตาม Schema
401	UNAUTHORIZED	API Key ไม่ถูกต้อง หรือไม่ได้แนบ Header x-api-key
403	FORBIDDEN	สิทธิ์ของ API Key ไม่ครอบคลุมคำสั่งนี้
429	RATE_LIMITED	เรียกใช้งานเกินโควตาต่อวินาที แนะนำให้ใช้ Exponential Backoff
500	INTERNAL_ERROR	ข้อผิดพลาดภายในเซิร์ฟเวอร์