Stable Pro API · v1
Errores
Problem Details (RFC 9457): un tipo estable con el que decidir, una frase en el idioma solicitado.
Los errores usan 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"
}
- Decide según
type: es estable y está en inglés, y es la dirección de la página que lo explica. Eltitletambién está en inglés. detailes una frase para las personas, en el idioma solicitado (?lang=,Accept-Language): muéstrala, nunca la analices.- Algunos tipos llevan campos adicionales:
reason(401),missing_permission(403),invalid_param(400). - Los cuerpos de los errores son abiertos: puede llegar un campo nuevo.
| Estado | type | Significado |
|---|---|---|
| 400 | invalid-request | La solicitud no es válida |
| 401 | unauthorized | La clave de la API falta o no es válida |
| 403 | forbidden | A la clave de la API le falta un permiso necesario |
| 403 | accounting-disabled | El plan de la cuadra no incluye el área Contabilidad |
| 404 | not-found | No encontrado |
| 429 | rate-limited | Demasiadas solicitudes |
| 500 | internal | Error interno |
| 503 | unavailable | Servicio no disponible temporalmente |
| 503 | events-not-ready | Los eventos de la cuadra se están preparando |