Skip to content
smallPict

รหัสข้อผิดพลาดและการวินิจฉัย

โครงสร้างข้อผิดพลาดมาตรฐาน 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

รหัสข้อความระบุสาเหตุแนวทางแก้ไข
400BAD_REQUESTรูปแบบ JSON ไม่ถูกต้องหรือพารามิเตอร์ผิดพลาดตรวจสอบไวยากรณ์ JSON และชื่อฟิลด์
401UNAUTHORIZEDไม่มีคีย์ API หรือคีย์ถูกยกเลิกแล้วตรวจสอบส่วนหัว X-API-Key
401TIMESTAMP_DRIFTเวลาในคำขอคลาดเคลื่อนเกิน ±300 วินาทีซิงค์เวลานาฬิกาเซิร์ฟเวอร์ผ่าน NTP
401INVALID_SIGNATUREลายเซ็น HMAC-SHA256 ไม่ตรงกันตรวจสอบข้อความมาตรฐานและ Secret Key
403FORBIDDENคีย์ไม่มีสิทธิ์เข้าถึงทรัพยากรนี้ปรับปรุงขอบเขตสิทธิ์ของคีย์ในแดชบอร์ด
404NOT_FOUNDไม่พบงาน (job_id) หรือไฟล์ที่ระบุตรวจสอบรหัสระบุในพาธ URL
413PAYLOAD_TOO_LARGEไฟล์มีขนาดเกินขีดจำกัดของแพ็กเกจของคุณย่อขนาดไฟล์ลงก่อนทำการอัปโหลด
415UNSUPPORTED_MEDIAรูปแบบไฟล์ไม่ได้รับการรองรับส่งเฉพาะไฟล์ JPEG, PNG, WebP, AVIF หรือ SVG
422UNPROCESSABLEนามสกุลถูกต้องแต่ข้อมูลไบนารีเสียหายตรวจสอบให้แน่ใจว่าไฟล์อัปโหลดได้สมบูรณ์
429RATE_LIMIT_EXCEEDEDส่งคำขอเกินจำนวนที่อนุญาตต่อวินาทีใช้ระบบหน่วงเวลา Exponential Backoff
429QUOTA_EXCEEDEDโควตาการแปลงไฟล์รายเดือนหมดลงอัปเกรดแพ็กเกจของคุณผ่านแดชบอร์ด
500INTERNAL_ERRORเกิดข้อผิดพลาดที่ไม่คาดคิดบนเซิร์ฟเวอร์ลองส่งคำขอใหม่อีกครั้งหลังจากนี้สักครู่
503SERVICE_UNAVAILABLEอยู่ระหว่างการปรับปรุงระบบชั่วคราวสลับไปใช้งานโหมด passthrough ชั่วคราว