# Erreurs

> Erreurs au format RFC 9457 (application/problem+json), codes HTTP et champ code stable.

URL : https://docs.fanconvert.ai/fr/api/rest/erreurs

Toutes les erreurs suivent la [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) (`application/problem+json`) :

```json
{
  "type": "https://fanconvert.app/problems/not-found",
  "title": "Ressource introuvable",
  "status": 404,
  "detail": "Créatrice introuvable : emma-demo",
  "instance": "urn:request:6c1e…",
  "code": "not-found",
  "params": {},
  "errors": []
}
```

- `code` est **stable** : c'est lui que votre code doit tester.
- `detail` est une phrase pour un humain : elle peut changer.
- `instance` est le numéro de la requête : donnez-le au [support](https://t.me/fanconvert), il retrouve l'appel.
- `errors` détaille, champ par champ, une saisie refusée (`422`).

| Statut | Quand | Que faire |
|---|---|---|
| 401 | clé absente, invalide, expirée ou révoquée | vérifiez l'en-tête `Authorization`, créez une nouvelle clé si besoin |
| 403 | droit manquant, ou personne non administratrice | `detail` nomme le droit ; créez une clé qui l'a |
| 404 | ressource introuvable **ou hors de la clé** | vérifiez l'identifiant et que la créatrice est dans la clé |
| 409 | conflit d'écriture (révision périmée) | relisez la ressource, puis réécrivez avec la révision à jour |
| 422 | paramètre invalide, ou `Idempotency-Key` réutilisée pour une autre requête | corrigez d'après `errors` |
| 429 | limite de requêtes atteinte | attendez `Retry-After` secondes ([Limites](/fr/api/rest/limites)) |
| 503 | service momentanément indisponible | réessayez plus tard, avec un délai croissant |