Aller au contenu

Dernière mise à jour : 15 octobre 2026

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.dev.djinn.solyntek.io

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

Le fichier est envoyé en multipart/form-data (champ file : PDF, DOCX ou image, 50 Mio au plus). document_type est optionnel : s'il est omis, le type est détecté.

Premier appel — extraction de document

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

curl -X POST https://api.dev.djinn.solyntek.io/v1/extract \
  -H "X-API-Key: votre_cle_api" \
  -F "file=@invoice.pdf" \
  -F "document_type=invoice"

Lire la réponse

Une réponse réussie (HTTP 200) retourne les données structurées extraites et une confidence entre 0 et 1 :

{
  "document_type": "invoice",
  "data": {
    "vendor_name": "Acme SAS",
    "invoice_number": "FAC-2026-0042",
    "invoice_date": "2026-05-01",
    "subtotal": 1041.67,
    "vat_amount": 208.33,
    "total_amount": 1250.00,
    "currency": "EUR"
  },
  "text_source": "native_pdf",
  "confidence": 0.93
}

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)
receipt Reçu
rib Relevé d'identité bancaire

Prochaines étapes