Gestione degli errori

Tutti gli errori restituiscono un oggetto JSON con un campo error:

{
  "error": "not enough storage, please upgrade your plan"
}

Codici di stato

Codice	Significato	Cause comuni
400	Richiesta non valida	Parametri mancanti o non validi, tipo di contenuto non supportato, corpo JSON non valido.
401	Non autorizzato	API key mancante o non valida.
402	Pagamento richiesto	Limite di archiviazione superato — aggiorna il tuo piano o attendi il reset mensile.
404	Non trovato	CID del file o utente non trovato.
429	Troppe richieste	Limite di larghezza di banda del gateway superato — attendi il reset mensile.
500	Errore interno	Errore imprevisto del server — riprova o contatta il supporto.

Errori client 4xx

I codici 4xx indicano un problema con la richiesta stessa. Verifica che la tua API key sia valida (401), che il corpo della richiesta sia un JSON correttamente formattato (400) e che il tuo limite di archiviazione non sia stato superato (402). Per i caricamenti in blocco tramite archivi .car, consulta la guida all'importazione CAR per i formati supportati.

Errori server 5xx

Una risposta 500 indica una condizione imprevista lato server. Riprova la richiesta dopo una breve attesa; se l'errore persiste, contatta il supporto indicando l'ID della richiesta presente negli header della risposta.