Errori
Formato della risposta
Tutti gli errori restituiscono un corpo JSON:
{
"error": {
"code": "validation_failed",
"message": "The given data was invalid.",
"details": {
"email": ["The email has already been taken."]
}
},
"request_id": "req_01HXXXXXX"
}
Includete sempre il request_id quando contattate il supporto per un errore.
Codici di stato HTTP
| Stato | Significato |
|---|---|
200 OK | Successo |
201 Created | Risorsa creata |
400 Bad Request | Richiesta malformata |
401 Unauthorized | Token mancante o non valido |
403 Forbidden | Token valido ma permessi insufficienti |
404 Not Found | Risorsa non trovata |
409 Conflict | Conflitto (es. email già in uso) |
422 Unprocessable Entity | Validazione fallita |
429 Too Many Requests | Limite di frequenza superato |
500 Internal Server Error | Errore lato server |
Codici di errore
| Codice | Descrizione |
|---|---|
validation_failed | Il corpo della richiesta ha fallito la validazione |
unauthorized | Token mancante o scaduto |
forbidden | Il token manca dell'ambito richiesto |
not_found | La risorsa non esiste |
conflict | Violazione del vincolo di unicità |
rate_limited | Troppe richieste |
internal_error | Errore del server imprevisto |