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 utilizzare questo tipo di errore anche 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.
• 413 - request_too_large: La richiesta supera il numero massimo consentito di byte.
• 429 - rate_limit_error: Il tuo account ha raggiunto un limite di frequenza.
• 500 - api_error: Si è verificato un errore imprevisto interno ai sistemi di Anthropic.
• 529 - overloaded_error: L’API di Anthropic è temporaneamente sovraccarica.

Quando si riceve una risposta in 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. Per 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 aumentino nel tempo.

​

ID della richiesta

Ogni risposta API include un’intestazione request-id univoca. Questa intestazione contiene un valore come req_018EeWyXxfu5pfWkrYcMdjWG. Quando contatti il supporto per una richiesta specifica, includi questo ID per aiutarci a risolvere rapidamente il tuo problema.