Aperçu de l'API

L'API v1 d'ImageToTable.ai extrait des données structurées à partir de photos, scans et PDF de documents réels — factures, reçus, relevés bancaires, bons de commande, etc. — et les renvoie au format JSON. Cette page présente les quatre ressources sur lesquelles repose l'ensemble de la documentation.

Concepts clés

Quatre ressources couvrent l'ensemble de la surface de l'API. Chaque endpoint de la section Référence opère sur l'une d'elles.

Document — une page unique traitée. Vous en créez un en téléchargeant une image ou une page PDF (un fichier PDF multipage produit plusieurs documents, un par page — voir la référence Documents). Un document suit un cycle de vie des statuts (queued → processing → succeeded / failed / canceled) expliqué en détail dans le guide du Modèle de tâche asynchrone.
Lot — un groupe nommé de documents téléchargés et traités ensemble. Chaque document appartient à un seul lot, identifié par son batch_name (une chaîne que vous choisissez, ou que l'API génère pour vous lors du téléchargement). Vous lancez le traitement, interrogez le statut et récupérez les résultats au niveau du lot.
Modèle — un ensemble réutilisable et enregistré de champs que vous souhaitez extraire à chaque fois (par exemple, un modèle « Facture fournisseur » avec invoice_number, vendor_name et total_amount). Les modèles vous évitent de redéclarer les mêmes champs à chaque appel process.
Champ — une valeur nommée unique que vous souhaitez extraire d'un document (un numéro de facture, une date, un montant d'article). Les champs résident soit sur un modèle, soit peuvent être déclarés en ligne, ponctuellement, sur un seul appel process sans jamais créer de modèle.

Comment ils s'articulent

Vous téléchargez un ou plusieurs fichiers dans un lot, chaque téléchargement devenant un Document. Vous lancez ensuite le traitement de ce lot, en indiquant à l'API les Champs que vous souhaitez récupérer — soit en pointant vers un Modèle enregistré, soit en listant les Champs directement dans le corps de la requête. Si vous ne spécifiez rien, l'API infère automatiquement des colonnes pertinentes. Une fois le traitement terminé, vous récupérez les résultats du lot : chaque Document renvoie un tableau line_items d'objets indexés par nom de champ.

Le JSON est le format principal

Le JSON est le format de réponse canonique et entièrement pris en charge pour chaque point d'accès. Les exports Excel (.xlsx) et Word (.docx) existent en tant que téléchargements pratiques basés sur les mêmes données (voir Référence des lots) — ils ne constituent pas un modèle de données distinct, et les intégrations API doivent être construites autour de la structure JSON.

Authentification et accès

Chaque requête v1 est authentifiée avec une clé API envoyée sous la forme Authorization: Bearer <clé> — pas de recours aux cookies de session, même si vous êtes connecté depuis le même navigateur. L'API v1 est accessible aux formules payantes (Basic et supérieur, y compris les équipes sur Growth et supérieur) ; les comptes en formule gratuite reçoivent une erreur plan_required. Consultez Configuration de l'environnement pour savoir où trouver votre clé.

Prochaines étapes

Prêt à passer votre premier appel ? Le Guide de démarrage rapide vous explique comment obtenir une clé, télécharger un document, lancer le traitement et récupérer les résultats — du début à la fin en environ cinq minutes. Pour la liste complète des points d'accès, consultez la Référence API. Si vous utilisez un assistant de codage IA pour l'intégration, pointez-le directement vers la spécification OpenAPI 3.1 — c'est le même schéma qui se cache derrière chaque page de Référence, lisible par machine de bout en bout.