Documentation - DocFlow

Comment ça marche ?

DocFlow vous permet d'automatiser le remplissage de formulaires PDF (AcroForm) via une API REST simple. Le processus se déroule en 3 étapes :

Téléchargez votre template

Uploadez un formulaire PDF avec des champs de formulaire (AcroForm). DocFlow extrait automatiquement le schéma des champs avec leur type, nom et options.

Consultez le schéma

Récupérez le schéma JSON du template pour connaître les champs disponibles et leurs types (texte, checkbox, dropdown, date, etc.).

Générez vos PDF

Envoyez vos données JSON à l'API et recevez une URL de téléchargement pour le PDF rempli. Le PDF peut être aplati (non éditable) ou garder ses champs de formulaire.

Base URL

Toutes les requêtes API doivent être envoyées à :

https://api.docflow.io/v1

Authentification

L'API utilise des clés API pour l'authentification. Incluez votre clé dans le header de chaque requête :

Authorization: Bearer df_votre_cle_api

Vous pouvez générer des clés API depuis votre tableau de bord.

Format des réponses

Toutes les réponses sont au format JSON et suivent cette structure :

{
  "data": { ... },        // Données de la réponse
  "meta": {               // Métadonnées optionnelles
    "page": 1,
    "limit": 20,
    "total": 100
  }
}

Gestion des erreurs

En cas d'erreur, la réponse contient un objet error :

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Le champ 'email' est invalide",
    "details": { ... }
  }
}

Codes d'erreur courants

Code HTTP	Code erreur	Description
400	VALIDATION_ERROR	Données invalides dans la requête
401	UNAUTHORIZED	Clé API manquante ou invalide
403	FORBIDDEN	Accès refusé à cette ressource
404	NOT_FOUND	Ressource non trouvée
429	RATE_LIMITED	Limite de requêtes atteinte
500	INTERNAL_ERROR	Erreur serveur

Rate Limiting

Les limites de requêtes dépendent de votre plan :

Plan	Requêtes/minute
Free	60
Pro	300
Business	1000

Les headers de réponse incluent les informations de rate limiting :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1640000000

Documentation DocFlow

Quickstart

Templates

Renders