AideAPIDémarrage rapide

Démarrage rapide

D'une clé API à un fichier téléchargé en cinq étapes.

Cinq étapes d'une clé à un fichier téléchargé.

L'API publique exécute un modèle que vous avez déjà créé dans DocTransform sur un fichier que vous envoyez depuis un script — sans aucun onglet de navigateur.

Les cinq étapes

Créer une clé

Depuis votre page de compte, Créer une clé. Copiez-la maintenant — elle n'est affichée qu'une seule fois.

L'enregistrer comme variable d'environnement

Chaque exemple sur ces pages lit la clé depuis DOCTRANSFORM_API_KEY, jamais comme un littéral dans la commande :

export DOCTRANSFORM_API_KEY=dt_live_...

Lister vos modèles

Trouvez l'id du modèle que vous voulez exécuter.

curl "https://doctransform.xyz/api/v1/templates" \
  -H "Authorization: Bearer $DOCTRANSFORM_API_KEY"

Créer une exécution

Envoyez un fichier pour exécuter ce modèle dessus.

curl -X POST "https://doctransform.xyz/api/v1/templates/tmpl_123/runs" \
  -H "Authorization: Bearer $DOCTRANSFORM_API_KEY" \
  -F "file=@/chemin/vers/votre/fichier.csv"

Seule une exécution qui renvoie un fichier compte dans vos exécutions mensuelles.

Interroger, puis télécharger

Une exécution rapide répond 201 immédiatement, le résultat est déjà prêt. Une plus longue répond 202 pendant qu'elle continue de travailler — interrogez GET /runs/{id} jusqu'à ce que son statut se stabilise, puis téléchargez :

curl "https://doctransform.xyz/api/v1/runs/run_abc/output" \
  -H "Authorization: Bearer $DOCTRANSFORM_API_KEY" \
  -o resultat.csv

Voir Authentification, Exécutions et Erreurs et limites pour le détail complet derrière chaque étape.