Errori

​

Errori HTTP

La nostra API segue un formato prevedibile di codici di errore HTTP:

• 400 - invalid_request_error: C’è stato un problema con il formato o il contenuto della tua richiesta. Potremmo anche usare questo tipo di errore per altri codici di stato 4XX non elencati di seguito.
• 401 - authentication_error: C’è un problema con la tua chiave API.
• 403 - permission_error: La tua chiave API non ha il permesso di utilizzare la risorsa specificata.
• 404 - not_found_error: La risorsa richiesta non è stata trovata.
• 429 - rate_limit_error: Il tuo account ha raggiunto un limite di velocità.
• 500 - api_error: Si è verificato un errore imprevisto all’interno dei sistemi di Anthropic.
• 529 - overloaded_error: L’API di Anthropic è temporaneamente sovraccarica.

Quando si riceve una risposta streaming tramite SSE, è possibile che si verifichi un errore dopo aver restituito una risposta 200, nel qual caso la gestione degli errori non seguirebbe questi meccanismi standard.

​

Forme degli errori

Gli errori vengono sempre restituiti come JSON, con un oggetto error di primo livello che include sempre un valore type e message. Ad esempio:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "La risorsa richiesta non è stata trovata."
  }
}

In conformità con la nostra politica di versioning, potremmo espandere i valori all’interno di questi oggetti, ed è possibile che i valori type crescano nel tempo.