API de génération PDF v1 — Sans état

API de génération de PDF
à partir de modèles professionnels

Générez des PDF à partir de vos modèles HTML, DOCX, Markdown ou JSON. Aucune rétention de données : aucun document ni donnée stocké.

Obtenez votre clé API Guide de démarrage rapide

4 formats d'entrée

Substitution de variables

Zéro stockage de données

SLA de disponibilité de 99,9 %

Démarrage rapide

Obtenez votre premier PDF en moins de 2 minutes. Créez une clé API, envoyez une demande et téléchargez le résultat.

Obtenez votre clé API

Créez une clé API depuis la console ci-dessous ou depuis votre tableau de bord.

Votre clé API est un secret. Ne l’exposez jamais dans le code frontend.

Envoyez votre première demande

Utilisez la commande cURL suivante pour générer un PDF :

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Téléchargez votre PDF

L'API renvoie le binaire PDF directement dans le corps de la réponse.

Le PDF généré est enregistré dans le fichier spécifié dans l'indicateur --output.

Démo en direct

Essayez l'API ici : modifiez le contenu et les variables, puis cliquez sur Générer pour voir votre PDF instantanément.

Connectez-vous pour essayer la démo

Créez un compte gratuit pour accéder au terrain de jeu en direct et générez jusqu'à 5 PDF de démonstration.

Créer un compte Se connecter

Console API

Gérez vos clés API et surveillez leur utilisation directement depuis cette page.

Connexion requise

Veuillez vous connecter pour créer et gérer vos clés API.

Créer un compte Se connecter

Authentification

Toutes les requêtes API nécessitent une clé API envoyée via l'en-tête X-API-Key.

Comment ça marche

Créez une clé API à partir de la console ou du tableau de bord.
Incluez-le dans chaque requête en tant qu'en-tête X-API-Key.
L'API valide votre clé et vérifie votre quota.
Les clés invalides ou révoquées renvoient une erreur 401.

Gardez votre clé API en sécurité. Utilisez des variables d'environnement, ne codez jamais en dur dans le code source.

Exemple de demande

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Réponse clé invalide (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Formats d'entrée

EasyPDF prend en charge 4 formats d'entrée. Choisissez celui qui correspond le mieux à votre flux de travail.

HTML

Prise en charge complète de CSS, pixel parfait via Chromium

DOCX

Télécharger des modèles Word avec des espaces réservés variables

Markdown

5 thèmes intégrés pour de beaux documents

Template JSON

Moteur Canvas pour un contrôle précis de la mise en page

HTML → PDF

Les plus populaires

Envoyez n'importe quel HTML avec CSS en ligne. Le moteur de rendu Chromium garantit un affichage du navigateur correspondant à une sortie parfaite au pixel près.

Principales fonctionnalités

Prise en charge complète de CSS3 (Flexbox, Grid, requêtes multimédias)
En-têtes et pieds de page personnalisés avec numéros de page
Substitution de variable avec la syntaxe {{variable}}
Mises en page réactives avec des formats de page A4/Lettre/Légal

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

Points de terminaison de l'API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Générez un PDF à partir de contenu HTML, Markdown ou modèle JSON.

Request Body (JSON)

Paramètre	Taper	Requis	Description
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	Chaîne de contenu HTML ou Markdown (obligatoire pour html/markdown)
`template_data`	`object`	Yes*	Objet JSON de modèle (obligatoire pour le format de modèle)
`variables`	`object`	No	Paires clé-valeur pour la substitution de variables
`options`	`object`	No	Options de génération PDF (format de page, marges, etc.)

Réponse

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Téléchargez un fichier DOCX pour le convertir en PDF avec remplacement de variable facultatif.

Form Fields

Field	Taper	Requis	Description
`file`	File	Yes	Le fichier .docx à convertir
`variables`	string (JSON)	No	Paires clé-valeur pour la substitution de variables
`options`	string (JSON)	No	Options PDF sous forme de chaîne JSON

POST/generate/previewAPI Key

Générez un aperçu PNG de la première page au lieu d'un PDF complet.

200Content-Type: image/png

GET/usageAPI Key

Vérifiez votre utilisation mensuelle actuelle et votre quota restant.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Créez une nouvelle clé API (nécessite une authentification JWT).

GET/keysJWT Bearer

Répertoriez toutes vos clés API avec des statistiques d'utilisation.

DELETE/keys/:key_idJWT Bearer

Révoquer (désactiver) définitivement une clé API.

Exemples de codes

Exemples complets et prêts à l’emploi dans la langue et le format de votre choix. Sélectionnez une langue et un format de saisie ci-dessous.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Cas d'utilisation

Découvrez comment les équipes utilisent l'API EasyPDF pour automatiser la génération de documents à grande échelle.

Factures et reçus

Générez des factures de marque avec des éléments de ligne dynamiques, des totaux et des détails sur le client.

HTML / DOCX

Contrats et accords

Remplissez les modèles Word avec les données du client et convertissez-les en PDF pour la signature.

DOCX

Certificats et diplômes

Créez des certificats personnalisés avec une mise en page et un positionnement précis.

Template JSON

Rapports et tableaux de bord

Transformez les données Markdown ou HTML en rapports PDF raffinés.

Markdown / HTML

Lettres et mailings

Générez des lettres personnalisées à partir de modèles DOCX pour les envois groupés.

DOCX

Documents de conformité

Produisez des documents de conformité prêts à être audités et infalsifiables.

HTML

Options PDF

Personnalisez la sortie avec ces paramètres facultatifs dans l'objet options.

Option	Taper	Défaut	Description
`page_format`	`string`	`"A4"`	Format de page : A4, Lettre, Légal, Tabloïd ou personnalisé
`landscape`	`boolean`	`false`	Activer l'orientation paysage
`margin_top`	`string`	`"20mm"`	Marge supérieure (unités CSS : mm, cm, in, px)
`margin_bottom`	`string`	`"20mm"`	Marge inférieure
`margin_left`	`string`	`"15mm"`	Marge gauche
`margin_right`	`string`	`"15mm"`	Marge droite
`header_html`	`string`	`null`	Contenu HTML pour l'en-tête de la page
`footer_html`	`string`	`null`	Contenu HTML pour le pied de page (prend en charge pageNumber, totalPages)
`theme`	`string`	`"modern"`	Thème Markdown : moderne, classique, minimal, github, académique

Exemple d'options complètes

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Gestion des erreurs

L'API renvoie des erreurs JSON structurées avec des codes d'erreur cohérents.

Format de réponse d'erreur

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Quand	Ce qu'il faut faire
`400`	`missing_content`	Champ obligatoire manquant	Vérifier les champs du corps de la demande
`400`	`invalid_json`	L'analyse JSON a échoué	Validez votre charge utile JSON
`400`	`unsupported_format`	Valeur de format inconnue	Utilisez du HTML, du markdown ou un modèle
`401`	`invalid_api_key`	Clé API introuvable	Vérifiez votre en-tête X-API-Key
`402`	`quota_exceeded`	Quota mensuel dépassé	Mettez à niveau votre forfait ou attendez la réinitialisation
`403`	`api_key_revoked`	La clé a été révoquée	Créer une nouvelle clé API
`429`	`rate_limit_exceeded`	Limite de débit atteinte	Attendez et réessayez avec une interruption exponentielle
`500`	`generation_failed`	Erreur de traitement interne	Vérifiez votre contenu pour les erreurs et réessayez

Limites de taux et quotas

Chaque forfait dispose d'un quota PDF mensuel et d'une limite de tarif par minute.

Limitation du débit

Les demandes dépassant votre limite de débit reçoivent une réponse 429 avec un en-tête Retry-After.

Réponse limitée en débit

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Quotas mensuels

L'utilisation est réinitialisée le 1er de chaque mois à minuit UTC.

Plan	PDFs/mois	Rate limit	Prix	Excédent
Starter	500	10/min	9€/mois	0,02€/PDF
Business	5 000	30/min	79€/mois	0,01€/PDF
Enterprise	Coutume	Coutume	Sur devis	Négociable

Meilleures pratiques

Suivez ces recommandations pour tirer le meilleur parti de l'API.

Utiliser des variables pour le contenu dynamique

Gardez vos modèles statiques et injectez des données via l'objet variables. C'est plus efficace que de reconstruire le HTML à chaque appel.

Gérer les erreurs avec élégance

Vérifiez toujours le code d'état HTTP. Implémentez des tentatives avec un intervalle exponentiel pour les erreurs 429 et 5xx.

Optimisez vos modèles

Minimisez les CSS, évitez les actifs externes (intégrez-les) et testez les modèles avant de les déployer en production.

Surveillez votre utilisation

Utilisez le point de terminaison /usage ou la console ci-dessus pour suivre la consommation et éviter les limites de quota inattendues.

Sécurisez vos clés API

Stockez les clés dans des variables d'environnement ou des gestionnaires de secrets. Faites pivoter périodiquement les clés et révoquez celles inutilisées.

Tarifs

Tarification simple et transparente. Payez uniquement ce que vous utilisez.

Starter

9€/mois

~0,018€ / PDF

500 PDFs / mois
10 requêtes/min
Les 4 formats d'entrée
Génération d'aperçu PNG
Assistance par e-mail
Excédent : 0,02€/PDF

Commencer

Meilleur rapport qualité-prix

Business

79€/mois

~0,016€ / PDF

5 000 PDFs / mois
30 requêtes/min
Toutes les fonctionnalités de démarrage
Assistance prioritaire
Tableau de bord d'analyse d'utilisation
Excédent : 0,01€/PDF