รหัสข้อผิดพลาดและการวินิจฉัย
โครงสร้างข้อผิดพลาดมาตรฐาน HTTP ตารางรหัสสถานะ และแนวทางการรับมือ
เมื่อคำขอไม่สามารถประมวลผลได้สำเร็จ SmallPict จะส่งคืนรหัสสถานะ HTTP มาตรฐานพร้อมโครงสร้าง JSON ที่ระบุรายละเอียดอย่างชัดเจนเพื่อช่วยให้คุณแก้ไขปัญหาได้อย่างรวดเร็ว
โครงสร้างข้อผิดพลาดแบบ JSON
JSON
{ "success": false, "error": { "code": "INVALID_IMAGE_PAYLOAD", "message": "ไฟล์ที่ส่งมาไม่ใช่รูปภาพที่ถูกต้องหรือไฟล์เสียหาย", "details": { "mime_type": "text/html", "expected": [ "image/jpeg", "image/png", "image/webp", "image/avif" ] } }}ตารางรหัสข้อผิดพลาด HTTP
| รหัส | ข้อความระบุ | สาเหตุ | แนวทางแก้ไข |
|---|---|---|---|
400 | BAD_REQUEST | รูปแบบ JSON ไม่ถูกต้องหรือพารามิเตอร์ผิดพลาด | ตรวจสอบไวยากรณ์ JSON และชื่อฟิลด์ |
401 | UNAUTHORIZED | ไม่มีคีย์ API หรือคีย์ถูกยกเลิกแล้ว | ตรวจสอบส่วนหัว X-API-Key |
401 | TIMESTAMP_DRIFT | เวลาในคำขอคลาดเคลื่อนเกิน ±300 วินาที | ซิงค์เวลานาฬิกาเซิร์ฟเวอร์ผ่าน NTP |
401 | INVALID_SIGNATURE | ลายเซ็น HMAC-SHA256 ไม่ตรงกัน | ตรวจสอบข้อความมาตรฐานและ Secret Key |
403 | FORBIDDEN | คีย์ไม่มีสิทธิ์เข้าถึงทรัพยากรนี้ | ปรับปรุงขอบเขตสิทธิ์ของคีย์ในแดชบอร์ด |
404 | NOT_FOUND | ไม่พบงาน (job_id) หรือไฟล์ที่ระบุ | ตรวจสอบรหัสระบุในพาธ URL |
413 | PAYLOAD_TOO_LARGE | ไฟล์มีขนาดเกินขีดจำกัดของแพ็กเกจของคุณ | ย่อขนาดไฟล์ลงก่อนทำการอัปโหลด |
415 | UNSUPPORTED_MEDIA | รูปแบบไฟล์ไม่ได้รับการรองรับ | ส่งเฉพาะไฟล์ JPEG, PNG, WebP, AVIF หรือ SVG |
422 | UNPROCESSABLE | นามสกุลถูกต้องแต่ข้อมูลไบนารีเสียหาย | ตรวจสอบให้แน่ใจว่าไฟล์อัปโหลดได้สมบูรณ์ |
429 | RATE_LIMIT_EXCEEDED | ส่งคำขอเกินจำนวนที่อนุญาตต่อวินาที | ใช้ระบบหน่วงเวลา Exponential Backoff |
429 | QUOTA_EXCEEDED | โควตาการแปลงไฟล์รายเดือนหมดลง | อัปเกรดแพ็กเกจของคุณผ่านแดชบอร์ด |
500 | INTERNAL_ERROR | เกิดข้อผิดพลาดที่ไม่คาดคิดบนเซิร์ฟเวอร์ | ลองส่งคำขอใหม่อีกครั้งหลังจากนี้สักครู่ |
503 | SERVICE_UNAVAILABLE | อยู่ระหว่างการปรับปรุงระบบชั่วคราว | สลับไปใช้งานโหมด passthrough ชั่วคราว |