malformed_request

Ce que cela signifie

C'est la requête elle-même qui est incorrecte, pas le document traité : un paramètre, un en-tête ou un champ du corps manque ou n'est pas valide. errors nomme chaque champ.

Que faire

Corrigez les champs listés dans errors et renvoyez la requête. La même requête échouera de la même façon.

Ce que contient la réponse

type

https://ironfang.uk/problems/malformed_request, la version anglaise de cette page.

status

Toujours 400 pour ce code.

code

malformed_request. Stable : basez votre logique sur cette valeur, pas sur le libellé de title ou de detail, que l'API fournit en anglais.

detail

Ce qui s'est passé cette fois-ci, en anglais ; peut être montré à une personne. Ne contient jamais le contenu de la facture.

request_id

La même valeur que l'en-tête X-Ironfang-Request-ID. Indiquez-la au support.

retry_after_seconds

Jamais présent pour ce code.

outcome

Absent. Ce code n'est une déclaration sur aucun document.

Les réponses de problème suivent la RFC 9457 et sont servies en application/problem+json. Un constat de validation n'est jamais une réponse de problème : une facture non valide est une réponse réussie qui liste ses constats. Consultez tous les types de problème, le guide Finance et le contrat OpenAPI (en anglais).