Aller au contenu

Démarrage rapide

Ce guide vous permet d'effectuer votre premier appel à l'API Djinn en quelques minutes.

Prérequis

  • Une clé API Djinn fournie par l'équipe Solyntek (X-API-Key)
  • curl ou tout client HTTP

URL de base

https://api.djinn.solyntek.io

Tous les endpoints sont versionnés sous /v1/.

Premier appel — extraction de document

L'exemple ci-dessous extrait les données structurées d'une facture PDF.

curl -X POST https://api.djinn.solyntek.io/v1/extract \
  -H "X-API-Key: votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "https://votre-stockage.fr/factures/facture-001.pdf",
    "document_type": "invoice"
  }'

Lire la réponse

Une réponse réussie (HTTP 200) retourne les données structurées extraites :

{
  "document_id": "ext_01j...",
  "document_type": "invoice",
  "data": {
    "vendor_name": "Acme SAS",
    "invoice_number": "FAC-2026-0042",
    "total_amount": 1250.00,
    "vat_rate": 20.0,
    "issue_date": "2026-05-01"
  },
  "confidence": 0.97
}

Types de documents supportés

Le service doc-extract prend en charge les types suivants pour le champ document_type :

Valeur Description
invoice Facture fournisseur
resume CV candidat
id_card Pièce d'identité (carte nationale, passeport)

Prochaines étapes