201) est le même objet que la lecture d’un résultat :
verdict, points d’attention, cachet 2D-Doc, identifiants — un seul format à intégrer, que le
dossier vienne d’un parcours ou d’une analyse directe.
Les deux natures de document
Le type réel du fichier est décidé par son contenu, jamais par une
déclaration. Limite : 10 Mo par fichier, préfixe data URL toléré.
« Analyse impossible » est un résultat
Un document que le moteur ne parvient pas à lire rend un201 avec
verdict: "analyse_impossible" — l’analyse a eu lieu, elle est enregistrée
et relisible, et votre système route ce dossier dans son propre processus.
Les erreurs HTTP ne parlent que de la requête (400, 413) ou de la
disponibilité du service (502, 503 — réessayez).
Un retry ne crée jamais deux analyses
Chaque appel étant un acte, protégez vos retries réseau avec l’en-têteIdempotency-Key : la même clé dans les 24 heures rend le même résultat,
sans nouvelle analyse. La réponse rejouée porte Idempotency-Replayed: true.
Le certificat
Ajoutez"includeCertificate": true pour recevoir, dans la même réponse, le
certificat PDF en base64 (certificate) — le même document que celui
téléchargé depuis le portail, n’affichant que les contrôles réellement
effectués. Son QR code pointe vers la page publique de vérification
d’authenticité. Il reste retéléchargeable à tout moment :
Débit
L’analyse directe a son propre plafond : 20 analyses par minute par clé, en plus du débit global. Au-delà,429 avec Retry-After. Pour un volume
important sans contrainte de temps réel, préférez un lot.