API de génération de PDF et documents Word : guide pratique pour développeurs

Générer des documents à la volée est l'un des besoins les plus courants d'une application moderne : factures, devis, contrats, attestations, bons de commande. Pourtant, produire un PDF propre et personnalisé par programme reste souvent pénible. Les bibliothèques de mise en page demandent du temps, le rendu varie d'un environnement à l'autre, et le moindre changement de design oblige à retoucher du code. Une API de génération de PDF résout ce problème : vous décrivez le document une fois sous forme de modèle, puis vous envoyez vos données, et l'API renvoie le fichier fini.

Cette page explique comment fonctionne la génération de documents par API avec DocX, l'API documentaire de Layerone, et comment l'intégrer en quelques minutes dans n'importe quel projet.

Le besoin : produire des documents sans réinventer la mise en page

La plupart des équipes qui veulent générer un PDF par API partent du même constat : le contenu change (le client, les montants, les dates) mais la mise en forme reste stable. Coder cette mise en forme ligne par ligne est fastidieux et fragile. L'approche par modèle inverse la logique : un graphiste ou un gérant prépare la maquette dans un outil qu'il maîtrise déjà — Microsoft Word — et le développeur se contente d'injecter les données.

Résultat : la maquette vit côté métier, le code reste minimal, et un changement de design ne demande plus de redéploiement. C'est exactement le principe de DocX.

Comment ça marche : un modèle Word + des données JSON → un PDF

Le fonctionnement de cette API de création de documents tient en trois étapes :

Vous préparez un modèle Word (.docx) avec des balises aux endroits à remplir, par exemple {{ client_nom }} ou {{ total_ttc }}.
Vous envoyez ce modèle et vos données au format JSON à l'API.
L'API renvoie le document fini, en PDF ou en Word selon votre choix, avec les balises remplacées par vos valeurs réelles.

Vos modèles sont stockés et versionnés côté serveur : vous pouvez les mettre à jour sans toucher au code de votre application, et revenir à une version précédente si besoin. La transformation template Word vers PDF est donc entièrement pilotée par l'API.

Exemple d'appel API

Toutes les requêtes s'authentifient avec un en-tête X-API-Key. Voici un appel minimal pour générer un document à partir d'un modèle et de données :

curl -X POST https://docx.layerone.fr/render-document \
  -H "X-API-Key: VOTRE_CLE_API" \
  -d "template_id=mon-modele" \
  --data-urlencode 'json_data={"client":"Boulangerie Martin","numero":"F-2026-0042","total":"1 250,00 €"}' \
  -d "output_filename=facture.pdf" \
  --output facture.pdf

L'API répond avec le fichier PDF prêt à être envoyé, archivé ou affiché. Pour la facturation électronique conforme à la réforme française 2026, l'endpoint POST /render-facturx produit directement une facture Factur-X au format PDF/A-3.

Cas d'usage concrets

L'API de génération de documents Word et PDF couvre la majorité des besoins documentaires d'une entreprise :

Factures et factures électroniques : génération automatique à chaque vente, au format PDF ou Factur-X pour la conformité 2026.
Devis : un modèle, des données, un devis prêt à envoyer en quelques millisecondes.
Contrats et conventions : remplissez les clauses variables (parties, montants, durées) à partir de votre base de données.
Attestations et certificats : attestations de paiement, de présence, de fin de travaux, générées en masse.
Bons de commande et rapports : tout document récurrent qui suit une trame fixe avec des données variables.

Les avantages de la génération par API

Rapide à intégrer : un seul appel HTTP, une clé API, et c'est en place. Pas de moteur de rendu à installer ni à maintenir.
Modèles versionnés : la maquette est gérée côté serveur, modifiable sans redéploiement, avec historique des versions.
Intégrable partout : DocX est disponible via npm, MCP (pour Claude, ChatGPT, Cursor), Zapier, Make, n8n, Pipedream, Bubble, Adalo et Postman. Une spécification OpenAPI publique permet aussi de générer un client dans le langage de votre choix.
Conformité intégrée : génération de factures Factur-X (PDF/A-3) conformes à la réforme française de la facture électronique.
Gratuit pour démarrer : 20 documents par mois offerts, sans carte bancaire, pour tester en conditions réelles.

Démarrer en quelques minutes

Pour générer vos premiers PDF par API, inscrivez-vous sur l'espace développeur, récupérez votre clé API et envoyez votre premier modèle. Le plan gratuit de 20 documents par mois suffit largement pour valider votre intégration avant de passer à l'échelle.

Obtenir une clé API gratuite Découvrir l'API

Questions fréquentes

La génération de PDF par API est-elle gratuite ?

Oui pour démarrer : l'offre gratuite de DocX inclut 20 documents par mois, sans carte bancaire. C'est suffisant pour tester la génération de PDF en conditions réelles avant de passer à un plan supérieur.

Comment obtenir une clé API pour générer des PDF ?

Vous créez un compte sur l'espace développeur https://dev.layerone.fr, puis vous récupérez votre clé API. Elle s'envoie dans l'en-tête X-API-Key de chaque requête vers https://docx.layerone.fr.

Dans quel format envoyer les données à l'API de génération ?

L'endpoint render-document attend des données au format application/x-www-form-urlencoded, et non du JSON brut. Vous transmettez trois champs : template_id (l'identifiant du modèle), json_data (vos données sérialisées en chaîne JSON) et output_filename (le nom du fichier de sortie).

Quels types de documents peut-on générer en PDF ?

Tout document récurrent suivant une trame fixe avec des données variables : factures et factures électroniques Factur-X, devis, contrats, attestations, bons de commande, rapports. Vous préparez le modèle une fois dans Word, l'API le remplit à chaque appel.