Erreurs · FanConvert Docs

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

Toutes les erreurs suivent la RFC 9457 (application/problem+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, 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)
503	service momentanément indisponible	réessayez plus tard, avec un délai croissant