Referensi

Kesalahan dan batas kecepatan

Kesalahan REST menggunakan amplop ini. Simpan ID permintaan dukungan dan jangan pernah mencatat kunci API Anda:

Mulailah dengan kode dan requestId

Kode stabil memberitahu program Anda apa yang terjadi. Pesan yang dapat dibaca manusia menjelaskan permintaan ini. Simpan requestId saat menghubungi dukungan.

JSON error response

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

Perbaiki kesalahan autentikasi dan rencana

Untuk 401, periksa apakah header dimulai dengan Bearer diikuti dengan satu spasi dan kunci aktif. Untuk 403, periksa paket akun dan cakupan yang dipilih saat kunci dibuat.

Perbaiki kesalahan status unggahan

Untuk 409 atau 422, konfirmasikan PUT selesai, Tipe Konten cocok, dan jumlah byte yang diunggah sama dengan sizeBytes. Buat pekerjaan unggahan baru jika URL sementara telah habis masa berlakunya.

Kode	HTTP	Artinya
BAD_REQUEST	400 / 409	HTTP 400 berarti isi permintaan tidak valid; HTTP 409 berarti pengunggahan tidak dapat diselesaikan dalam kondisi saat ini.
UNAUTHORIZED	401	Kunci API hilang, tidak valid, atau dicabut.
PAID_PLAN_REQUIRED	403	Akun tersebut tidak memiliki paket berbayar yang memenuhi syarat.
INSUFFICIENT_SCOPE	403	Kunci API tidak mencakup cakupan yang diperlukan.
NOT_FOUND	404	Unggahan, file, atau pembagian yang dimiliki tidak ditemukan.
UPLOAD_NOT_READY	409	Objek yang diunggah belum siap untuk diselesaikan.
FILE_TOO_LARGE	413	File melebihi batas ukuran yang berlaku.
OBJECT_VALIDATION_FAILED	422	Validasi objek yang diunggah gagal.
QUOTA_EXCEEDED	429	Kuota upload sudah habis.
RATE_LIMIT_EXCEEDED	429	Tingkat permintaan API telah habis.
SERVICE_UNAVAILABLE	503	Layanan yang diperlukan untuk sementara tidak tersedia.

Header batas kecepatan

Coba lagi 429 hanya setelah Retry-After. Coba lagi kesalahan 503 sementara dengan backoff eksponensial. Jangan mencoba lagi permintaan 400, 401, atau 403 yang tidak valid secara otomatis.