Erreurs

Quand une requête échoue, l'API répond avec un statut HTTP d'erreur et un corps en application/problem+json, le format de la RFC 9457.

Le format

Chaque erreur porte ces champs :

type: L'adresse de la page qui documente l'erreur.
title: Le résumé de l'erreur, en français, toujours le même pour un code.
status: Le statut HTTP de la réponse.
detail: L'explication de cette occurrence, en français. Elle ne cite jamais une donnée personnelle, pas même l'entrée.
instance: L'identifiant de cette occurrence, tiré de l'en-tête X-Request-ID de la réponse. Absent de l'erreur d'un élément d'un lot.
code: L'identifiant stable de l'erreur.

Décide d'après code : title et detail sont des textes faits pour être lus.
La liste des codes est ouverte : un code que tu ne connais pas encore peut apparaître. Traite-le d'après status.
Quand tu signales un problème, cite instance.

Statut	Code	Titre
400	`invalid_body`	Corps de requête invalide
400	`invalid_parameter`	Paramètre invalide
400	`missing_parameter`	Paramètre manquant
401	`invalid_api_key`	Clé API invalide
401	`missing_api_key`	Clé API manquante
403	`challenge_failed`	Vérification anti-abus échouée
404	`not_found`	Ressource introuvable
405	`method_not_allowed`	Méthode non autorisée
413	`content_too_large`	Corps de requête trop gros
415	`unsupported_media_type`	Type de contenu non pris en charge
422	`invalid_input`	Entrée invalide
422	`invalid_login_link`	Lien de connexion invalide
422	`too_many_items`	Trop d'éléments
429	`too_many_requests`	Trop de requêtes
500	`internal_error`	Erreur interne
503	`authentication_unavailable`	Authentification indisponible
503	`challenge_unavailable`	Vérification anti-abus indisponible
503	`key_request_unavailable`	Demande de clé indisponible
503	`service_unavailable`	Service indisponible