Erreurs

Les erreurs utilisent les Problem Details (RFC 9457), avec 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"
}

• Décidez selon type : il est stable et en anglais, et c'est l'adresse de la page qui l'explique. Le title est aussi en anglais.
• detail est une phrase destinée aux personnes, dans la langue demandée (?lang=, Accept-Language) : affichez-la, ne l'analysez jamais.
• Certains types portent des champs supplémentaires : reason (401), missing_permission (403), invalid_param (400).
• Les corps d'erreur sont ouverts : un nouveau champ peut arriver.