Stable Pro API · v1
Errori
Problem Details (RFC 9457): un tipo stabile su cui decidere, una frase nella lingua richiesta.
Gli errori usano i Problem Details (RFC 9457), con Content-Type: application/problem+json:
{
"type": "https://stable-pro.com/docs/api/problems/forbidden",
"title": "The API key lacks a required permission",
"status": 403,
"detail": "La chiave non ha il permesso receipts:read: lo può accendere il titolare della scuderia in Impostazioni → Collegamenti.",
"missing_permission": "receipts:read"
}
- Decidi in base a
type: è stabile e in inglese, ed è l'indirizzo della pagina che lo spiega. Anche iltitleè in inglese. detailè una frase per le persone, nella lingua richiesta (?lang=,Accept-Language): mostrala, non analizzarla mai.- Alcuni tipi portano campi in più:
reason(401),missing_permission(403),invalid_param(400). - I corpi degli errori sono aperti: può arrivare un campo nuovo.
| Stato | type | Cosa vuol dire |
|---|---|---|
| 400 | invalid-request | La richiesta non è valida |
| 401 | unauthorized | La chiave dell'API manca o non è valida |
| 403 | forbidden | La chiave dell'API non ha un permesso che serve |
| 403 | accounting-disabled | Il piano della scuderia non comprende l'area Contabilità |
| 404 | not-found | Non trovato |
| 429 | rate-limited | Troppe richieste |
| 500 | internal | Errore interno |
| 503 | unavailable | Servizio non disponibile per il momento |
| 503 | events-not-ready | Le novità della scuderia sono in preparazione |