เรียกดูเอกสารสำหรับนักพัฒนา

อ้างอิง

ข้อผิดพลาดและการจำกัดอัตรา

ข้อผิดพลาด REST ใช้ซองจดหมายนี้ เก็บ ID คำขอเพื่อรับการสนับสนุนและอย่าบันทึกคีย์ API ของคุณ:

เริ่มต้นด้วยรหัสและ requestId

รหัสที่เสถียรจะบอกโปรแกรมของคุณว่าเกิดอะไรขึ้น ข้อความที่มนุษย์สามารถอ่านได้จะอธิบายคำขอนี้ บันทึก requestId เมื่อติดต่อฝ่ายสนับสนุน

JSON error response
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

แก้ไขข้อผิดพลาดในการตรวจสอบสิทธิ์และแผน

สำหรับ 401 ให้ตรวจสอบว่าส่วนหัวขึ้นต้นด้วย Bearer ตามด้วยช่องว่างหนึ่งช่องและคีย์ที่ใช้งานอยู่ สำหรับ 403 ให้ตรวจสอบแผนบัญชีและขอบเขตที่เลือกเมื่อสร้างคีย์

แก้ไขข้อผิดพลาดสถานะการอัปโหลด

สำหรับ 409 หรือ 422 ให้ยืนยันว่า PUT เสร็จสิ้น ตรงกับประเภทเนื้อหา และจำนวนไบต์ที่อัปโหลดเท่ากับ sizeBytes สร้างงานอัปโหลดใหม่หาก URL ชั่วคราวหมดอายุ

รหัสHTTPความหมาย
BAD_REQUEST400 / 409HTTP 400 หมายถึงเนื้อหาคำขอไม่ถูกต้อง HTTP 409 หมายความว่าไม่สามารถอัปโหลดให้เสร็จสิ้นในสถานะปัจจุบันได้
UNAUTHORIZED401รหัส API หายไป ไม่ถูกต้อง หรือถูกเพิกถอน
PAID_PLAN_REQUIRED403บัญชีไม่มีแผนการชำระเงินที่มีสิทธิ์
INSUFFICIENT_SCOPE403คีย์ API ไม่รวมขอบเขตที่จำเป็น
NOT_FOUND404ไม่พบการอัปโหลด ไฟล์ หรือการแชร์ที่เป็นเจ้าของ
UPLOAD_NOT_READY409วัตถุที่อัปโหลดไม่พร้อมสำหรับการดำเนินการให้เสร็จสิ้น
FILE_TOO_LARGE413ไฟล์มีขนาดเกินขีดจำกัดที่กำหนด
OBJECT_VALIDATION_FAILED422วัตถุที่อัปโหลดไม่ผ่านการตรวจสอบ
QUOTA_EXCEEDED429โควต้าการอัปโหลดหมดลงแล้ว
RATE_LIMIT_EXCEEDED429อัตราคำขอ API หมดแล้ว
SERVICE_UNAVAILABLE503บริการที่จำเป็นไม่สามารถใช้งานได้ชั่วคราว

ส่วนหัวจำกัดอัตรา

ลอง 429 อีกครั้งหลังจาก Retry-After เท่านั้น ลองข้อผิดพลาด 503 ชั่วคราวอีกครั้งโดยใช้ Exponential Backoff อย่าลองคำขอ 400, 401 หรือ 403 ที่ไม่ถูกต้องอีกครั้งโดยอัตโนมัติ