Codici di Errore

Comprendere le risposte di errore API

Formato della Risposta di Errore
Tutte le risposte di errore seguono questo formato:
{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}
Codici di Errore
400Bad Request

I parametri della richiesta non sono validi o sono malformati.

Soluzione: Controlla il corpo della tua richiesta e assicurati che tutti i campi obbligatori siano presenti e contengano valori validi.

401Unauthorized

Chiave API non valida o mancante.

Soluzione: Assicurati di includere una chiave API valida nell'intestazione Authorization.

402Payment Required

Crediti insufficienti nel tuo portafoglio API.

Soluzione: Acquista più crediti o attendi che i tuoi crediti si ricarichino.

403Forbidden

Accesso API non approvato o account sospeso.

Soluzione: Contatta l'assistenza se ritieni si tratti di un errore.

404Not Found

La risorsa richiesta (attività, webhook, ecc.) non è stata trovata.

Soluzione: Verifica che l'ID della risorsa sia corretto.

429Too Many Requests

Troppe richieste in un breve lasso di tempo.

Soluzione: Implementa il backoff esponenziale e rispetta i limiti di frequenza.

500Internal Server Error

Si è verificato un problema sul nostro sistema.

Soluzione: Riprova la richiesta dopo una breve pausa. Se il problema persiste, contatta l'assistenza.

Limiti di Frequenza
Limiti di velocità predefiniti:
MetricoLimite
Richieste al minuto60
Richieste al giorno10,000
Attività concorrenti5
Nano Banana Pro API