La documentation de l’API.
Elle est publique, en français, générée depuis le contrat OpenAPI et hébergée avec l’API : https://api.kachet.fr/docs.
Ce qu’elle contient.
Les deux services, analyse d’un document et extraction, leurs schémas de requête et de réponse, les 41 codes publics, les scénarios de test, la signature des webhooks, et quatorze guides pas à pas, du démarrage à l’interprétation des constats.
Les clés de test sont gratuites et donnent des résultats fixes : document sain, bulletin retouché, 2D-Doc mal signé, identité discordante, document illisible.
Ce qu’il faut savoir avant d’intégrer.
Mode test reproductible
Une clé de test ne lance jamais d’analyse réelle et ne coûte rien. Un en-tête choisit le scénario : avis sans anomalie, bulletin retouché, 2D-Doc mal signé, identité discordante, document illisible, analyse longue, échec ; et cinq scénarios de dossier. Même forme qu’un résultat réel, même webhook.
Idempotence
L’en-tête Idempotency-Key rend un renvoi sans risque : après une coupure réseau ou un délai dépassé, la même clé d’idempotence dans les 24 heures rend l’analyse existante, sans nouvelle analyse ni nouvelle facturation. Une clé neuve est une nouvelle analyse, facturée.
Webhooks signés
Un seul événement, analysis.finished, pour une vérification comme pour un dossier. Signature horodatée dans l’en-tête, identifiant stable pour dédoublonner, reprises automatiques.
Plafond de dépense par clé
Chaque clé porte un plafond mensuel qui protège votre budget d’une boucle d’envois ou d’une clé divulguée. Atteint, seule cette clé est arrêtée ; les autres continuent.
Deux services
POST /v1/extractions lit un document sans l’analyser, rien n’est gardé. POST /v1/verifications rend les mêmes données lues tout de suite, puis le résultat complet par webhook ou par GET. Option wait=false pour les envois en masse.
Prix publics, sans rendez-vous.
Compte ouvert sur demande [Q1], [QUOTA] analyses réelles gratuites sur vos propres dossiers, puis [PRIX] € HT par document, dégressif, sans engagement.