Riferimento

Errori e limiti di velocità

Gli errori REST utilizzano questa busta. Conserva la richiesta ID per supporto e non registrare mai la tua chiave API:

Inizia con il codice e requestId

Il codice stabile indica il tuo programma cosa è successo. Il messaggio leggibile dall'uomo spiega questa richiesta. Salva requestId quando contatti l'assistenza.

JSON error response

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

Correggere gli errori di autenticazione e pianificazione

Per 401, verificare che l'intestazione inizi con Bearer seguito da uno spazio e una chiave attiva. Per 403, controllare il piano dell'account e gli ambiti selezionati al momento della creazione della chiave.

Correggi gli errori dello stato di caricamento

Per 409 o 422, conferma che PUT è terminato, corrisponde al tipo di contenuto e il conteggio dei byte caricati è uguale a sizeBytes. Crea un nuovo processo di caricamento se il URL temporaneo è scaduto.

Codice	HTTP	Significato
BAD_REQUEST	400 / 409	HTTP 400 significa che il corpo della richiesta non è valido; HTTP 409 significa che il caricamento non può essere completato nello stato attuale.
UNAUTHORIZED	401	La chiave API manca, non è valida o è revocata.
PAID_PLAN_REQUIRED	403	L'account non dispone di un piano a pagamento idoneo.
INSUFFICIENT_SCOPE	403	La chiave API non include l'ambito richiesto.
NOT_FOUND	404	Il caricamento, il file o la condivisione di proprietà non è stato trovato.
UPLOAD_NOT_READY	409	L'oggetto caricato non è pronto per il completamento.
FILE_TOO_LARGE	413	Il file supera il limite di dimensione applicabile.
OBJECT_VALIDATION_FAILED	422	L'oggetto caricato non ha superato la convalida.
QUOTA_EXCEEDED	429	La quota di caricamento è esaurita.
RATE_LIMIT_EXCEEDED	429	Il tasso di richiesta API è esaurito.
SERVICE_UNAVAILABLE	503	Un servizio richiesto è temporaneamente non disponibile.

Intestazioni del limite di velocità

Riprova 429 solo dopo Riprova-Dopo. Riprova errori temporanei 503 con backoff esponenziale. Non riprovare automaticamente le richieste 400, 401 o 403 non valide.