Démarrage rapide#

L'API publique de DokKraft est une API REST JSON authentifiée par clé d'espace de travail. Objectif de cette page : votre premier PDF en cinq minutes.

1. Créer une clé API#

Dans DokKraft : Paramètres → Clés API (rôle gestionnaire requis). La clé s'affiche une seule fois — copiez-la immédiatement :

dfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

La clé porte le périmètre de son espace : elle ne voit que les templates et dossiers de cet espace.

2. Premier appel : générer un PDF#

Récupérez le public_id d'un template (barre d'adresse du studio) puis :

curl -X POST "https://dokkraft.blocsland.com/api/v1/templates/{public_id}/pdf" \
  -H "Authorization: Bearer dfk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"data": {"client.nom": "ACME Corp"}}'

Réponse : le PDF en flux (inline par défaut, pièce jointe avec "download": true).

3. Archiver un document numéroté#

Pour créer un document dans l'espace (numérotation + archivage), utilisez plutôt :

curl -X POST "https://dokkraft.blocsland.com/api/v1/templates/{public_id}/documents" \
  -H "Authorization: Bearer dfk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"name": "Facture ACME", "data": {"client.nom": "ACME Corp"}}'

Réponse 201 avec la fiche du document (statut, numéro, URL du PDF). Deux refus possibles : 422 si un champ obligatoire du template manque (format {message, errors}), 503 pdf_busy si le rendu synchrone est saturé (en-tête Retry-After — relancez ou passez en async=true). Tous les codes sont détaillés dans Erreurs.

4. Créer plusieurs documents d'un coup#

Dès qu'il s'agit de plus de quelques documents, utilisez le lot (batch) : une seule requête, exécution asynchrone, suivi item par item.

curl -X POST "https://dokkraft.blocsland.com/api/v1/templates/{public_id}/documents/batch" \
  -H "Authorization: Bearer dfk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"name": "Facture A"}, {"name": "Facture B"}]}'

Réponse 202 avec un identifiant de lot, puis GET /api/v1/batches/{batch_id} pour suivre l'avancement et récupérer les PDF. En production, un webhook peut vous prévenir de la fin du lot à la place du sondage.

Étape suivante#

• Référence complète de tous les endpoints.
• Codes d'erreur et gestion des quotas.
• Webhooks : soyez prévenu dès qu'un PDF est prêt, au lieu de sonder.
• Testez tout ça en direct dans l'onglet Intégration API de votre espace (mode « Lot » de la sandbox).