Analyser un document
Analyse immédiate d’un document que votre système détient déjà — tunnel web, application, agence, GED — sans parcours à faire suivre. La réponse synchrone porte le résultat complet, au même format que la lecture. « Analyse impossible » est un RÉSULTAT (201), enregistré et relisible : les erreurs HTTP ne parlent que de la requête ou de la disponibilité du service. Débit dédié : 20 analyses par minute et par clé. En-tête optionnel Idempotency-Key (≤ 255 caractères, fenêtre 24 h) : un retry réseau avec la même clé rend le même résultat — jamais une seconde analyse. La réponse rejouée porte l’en-tête Idempotency-Replayed: true.
Authorizations
Clé API créée dans Administration → Entreprise → Clés API (licence Groupe).
Headers
Même clé dans les 24 h → même résultat, pas de second acte.
255Body
Nature du document transmis.
identite, administratif Le document en base64 (préfixe data URL toléré). Identité : image JPEG, PNG ou WebP — le recto. Administratif : image ou PDF, fichier unique. 10 Mo maximum.
Verso de la pièce d'identité (base64, optionnel). Refusé pour un document administratif.
Votre référence de dossier — renvoyée dans le résultat et filtrable en lecture.
255Joint le certificat PDF (base64) à la réponse.
Response
Le résultat de l'analyse — même forme que la lecture, plus le certificat si demandé.
Résultat d'une vérification.
Identifiant unique du résultat.
"CSL-20260717-3F2A91"
Votre référence de dossier, renvoyée telle quelle.
"DOSSIER-88412"
Workflow qui a évalué le document.
"WFL-20260706-BEF798"
Catégorie du document contrôlé.
identite, administratif Type de document détecté.
"CNI"
Pays émetteur (ISO 3166-1 alpha-3).
"FRA"
Constat technique de l'analyse — immuable.
conforme, non_conforme, suspect, analyse_impossible Décision du workflow selon vos règles.
conforme, a_verifier, refuse, null Décision de traitement de votre équipe (revue humaine).
pending, accepted, rejected, null Nombre de points d'attention relevés.
Au moins un point d'attention bloquant.
Points d'attention relevés par l'analyse.
Cachet électronique 2D-Doc du document (null si aucun 2D-Doc et rien à signaler).
Date de l'analyse.
Date d'enregistrement.
Certificat PDF en base64 — présent si includeCertificate est vrai.
Adresse de retéléchargement du certificat.

