Referans

Hatalar ve hız sınırları

REST hataları bu zarfı kullanır. Destek için istek kimliğini saklayın ve API anahtarınızı hiçbir zaman kaydetmeyin:

Kod ve requestId ile başlayın

Kararlı kod programınıza ne olduğunu anlatır. İnsan tarafından okunabilen mesaj bu isteği açıklıyor. Destek ekibiyle iletişime geçtiğinizde requestId'yi kaydedin.

JSON error response

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

Kimlik doğrulama ve planlama hatalarını düzeltme

401 için başlığın Taşıyıcı ile başlayıp, ardından bir boşluk ve aktif bir anahtarla başlayıp başlamadığını kontrol edin. 403 için hesap planını ve anahtar oluşturulduğunda seçilen kapsamları kontrol edin.

Yükleme durumu hatalarını düzeltin

409 veya 422 için PUT'un tamamlandığını, İçerik Türü eşleştiğini ve yüklenen bayt sayısının sizeBytes'a eşit olduğunu doğrulayın. Geçici URL süresi dolmuşsa yeni bir yükleme işi oluşturun.

Kod	HTTP	Anlam
BAD_REQUEST	400 / 409	HTTP 400, istek gövdesinin geçersiz olduğu anlamına gelir; HTTP 409, yüklemenin mevcut durumunda tamamlanamayacağı anlamına gelir.
UNAUTHORIZED	401	API anahtarı eksik, geçersiz veya iptal edilmiş.
PAID_PLAN_REQUIRED	403	Hesabın uygun bir ücretli planı yok.
INSUFFICIENT_SCOPE	403	API anahtarı gerekli kapsamı içermiyor.
NOT_FOUND	404	Sahip olunan yükleme, dosya veya paylaşım bulunamadı.
UPLOAD_NOT_READY	409	Yüklenen nesne tamamlanmaya hazır değil.
FILE_TOO_LARGE	413	Dosya geçerli boyut sınırını aşıyor.
OBJECT_VALIDATION_FAILED	422	Yüklenen nesne doğrulamada başarısız oldu.
QUOTA_EXCEEDED	429	Yükleme kotası doldu.
RATE_LIMIT_EXCEEDED	429	API istek oranı tükendi.
SERVICE_UNAVAILABLE	503	Gerekli bir hizmet geçici olarak kullanılamıyor.

Hız sınırı başlıkları

429'u yalnızca Sonra Yeniden Dene'den sonra yeniden deneyin. Üstel geri çekilmeyle geçici 503 hatalarını yeniden deneyin. Geçersiz 400, 401 veya 403 isteklerini otomatik olarak yeniden denemeyin.