อ้างอิง
ข้อผิดพลาดและการจำกัดอัตรา
ข้อผิดพลาด REST ใช้ซองจดหมายนี้ เก็บ ID คำขอเพื่อรับการสนับสนุนและอย่าบันทึกคีย์ API ของคุณ:
เริ่มต้นด้วยรหัสและ requestId
รหัสที่เสถียรจะบอกโปรแกรมของคุณว่าเกิดอะไรขึ้น ข้อความที่มนุษย์สามารถอ่านได้จะอธิบายคำขอนี้ บันทึก requestId เมื่อติดต่อฝ่ายสนับสนุน
{
"error": {
"code": "UNAUTHORIZED",
"message": "The API key is missing, invalid, or revoked.",
"requestId": "req_..."
}
}แก้ไขข้อผิดพลาดในการตรวจสอบสิทธิ์และแผน
สำหรับ 401 ให้ตรวจสอบว่าส่วนหัวขึ้นต้นด้วย Bearer ตามด้วยช่องว่างหนึ่งช่องและคีย์ที่ใช้งานอยู่ สำหรับ 403 ให้ตรวจสอบแผนบัญชีและขอบเขตที่เลือกเมื่อสร้างคีย์
แก้ไขข้อผิดพลาดสถานะการอัปโหลด
สำหรับ 409 หรือ 422 ให้ยืนยันว่า PUT เสร็จสิ้น ตรงกับประเภทเนื้อหา และจำนวนไบต์ที่อัปโหลดเท่ากับ sizeBytes สร้างงานอัปโหลดใหม่หาก URL ชั่วคราวหมดอายุ
| รหัส | HTTP | ความหมาย |
|---|---|---|
| BAD_REQUEST | 400 / 409 | HTTP 400 หมายถึงเนื้อหาคำขอไม่ถูกต้อง HTTP 409 หมายความว่าไม่สามารถอัปโหลดให้เสร็จสิ้นในสถานะปัจจุบันได้ |
| UNAUTHORIZED | 401 | รหัส API หายไป ไม่ถูกต้อง หรือถูกเพิกถอน |
| PAID_PLAN_REQUIRED | 403 | บัญชีไม่มีแผนการชำระเงินที่มีสิทธิ์ |
| INSUFFICIENT_SCOPE | 403 | คีย์ API ไม่รวมขอบเขตที่จำเป็น |
| NOT_FOUND | 404 | ไม่พบการอัปโหลด ไฟล์ หรือการแชร์ที่เป็นเจ้าของ |
| UPLOAD_NOT_READY | 409 | วัตถุที่อัปโหลดไม่พร้อมสำหรับการดำเนินการให้เสร็จสิ้น |
| FILE_TOO_LARGE | 413 | ไฟล์มีขนาดเกินขีดจำกัดที่กำหนด |
| OBJECT_VALIDATION_FAILED | 422 | วัตถุที่อัปโหลดไม่ผ่านการตรวจสอบ |
| QUOTA_EXCEEDED | 429 | โควต้าการอัปโหลดหมดลงแล้ว |
| RATE_LIMIT_EXCEEDED | 429 | อัตราคำขอ API หมดแล้ว |
| SERVICE_UNAVAILABLE | 503 | บริการที่จำเป็นไม่สามารถใช้งานได้ชั่วคราว |
ส่วนหัวจำกัดอัตรา
ลอง 429 อีกครั้งหลังจาก Retry-After เท่านั้น ลองข้อผิดพลาด 503 ชั่วคราวอีกครั้งโดยใช้ Exponential Backoff อย่าลองคำขอ 400, 401 หรือ 403 ที่ไม่ถูกต้องอีกครั้งโดยอัตโนมัติ
