\begin{pdf-api}
API de génération de PDF
Une API de génération de PDF vous permet de compiler des documents par programmation avec une seule requête HTTP, sans outillage local. FormaTeX fournit une API REST basée sur LaTeX qui produit des PDF de qualité publication depuis n'importe quel langage, framework ou outil d'automatisation.
\section{Definition}
Qu'est-ce qu'une API de génération de PDF ?
Une API de génération de PDF est un service REST qui accepte une source de document (HTML, LaTeX, Markdown ou un modèle) et renvoie un fichier PDF compilé sous forme de réponse binaire. Au lieu d'installer des outils PDF sur chaque machine qui doit produire des documents, vous envoyez une requête HTTP depuis n'importe quel langage ou plateforme et recevez un PDF prêt à l'emploi dans le corps de la réponse.
N'importe quel langage, n'importe quelle plateforme
Un simple POST HTTP fonctionne depuis Python, Node.js, Go, Ruby, PHP ou tout outil no-code disposant d'une action HTTP.
Aucune installation locale
Pas de TeX Live, wkhtmltopdf, Chrome headless ou Puppeteer à installer, mettre à jour ou maintenir sur vos serveurs.
Résultat prévisible
Une API managée produit un résultat identique d'un environnement à l'autre. Fini les bugs de PDF du type « le rendu est différent en CI ».
\section{Comparison}
API de PDF basées sur LaTeX ou sur HTML
| Fonctionnalité | API LaTeX (FormaTeX) | API HTML vers PDF |
|---|---|---|
| Qualité typographique | Professionnelle : Knuth–Plass, microtypographie | Rendu de niveau navigateur |
| Mathématiques | amsmath natif, prise en charge complète des équations | Contournement MathJax/KaTeX |
| Contrôle de la mise en page | Précis : marges, colonnes, en-têtes, pieds de page | Approximation CSS, particularités d'impression |
| Documents longs | Table des matières, références croisées, bibliographie | Complexe à gérer de façon fiable |
| Polices | Prise en charge complète OTF/TTF avec xelatex/lualatex | Limitées aux polices système/web |
| Format source | LaTeX (.tex) | HTML + CSS |
| Complexité de mise en place | Courbe initiale plus raide, gain énorme | Familier si vous connaissez HTML/CSS |
| Idéal pour | Rapports, articles, factures, certificats | Reçus simples, instantanés de pages web |
\section{FormaTeX}
L'approche de FormaTeX
FormaTeX exécute une distribution TeX Live complète dans un environnement isolé côté serveur. Chaque requête de compilation obtient un bac à sable neuf : aucune contamination entre les tâches, aucun fichier auxiliaire périmé, aucun risque de sécurité lié au LaTeX fourni par l'utilisateur. Le PDF compilé est renvoyé en octets bruts dans la réponse HTTP, puis supprimé de nos serveurs.
Compilation synchrone
Envoyez un POST à /api/v1/compile et recevez directement les octets du PDF dans la réponse. Idéal pour la génération à la demande lorsque vous avez besoin du fichier immédiatement.
Trois moteurs LaTeX
Choisissez pdflatex (rapide, compatibilité maximale), xelatex (Unicode, polices système) ou lualatex (scripts Lua, typographie avancée).
Compilation éphémère
Votre code source LaTeX et le PDF compilé sont supprimés de nos serveurs immédiatement après l'envoi de la réponse. Rien n'est conservé.
Authentification simple
Transmettez votre clé API dans l'en-tête X-API-Key. Générez autant de clés que nécessaire depuis le tableau de bord et révoquez-les individuellement.
\section{Démarrage rapide}
Compilez votre premier PDF en 30 secondes
Exécutez cette commande curl après avoir remplacé YOUR_API_KEY par votre clé FormaTeX. L'option --output hello.pdf enregistre les octets bruts du PDF dans un fichier du répertoire courant.
curl -X POST https://api.formatex.io/api/v1/compile \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"latex": "\\documentclass{article}\n\\begin{document}\n\\title{Hello, FormaTeX!}\n\\author{Your Name}\n\\date{\\today}\n\\maketitle\n\nThis PDF was generated via the FormaTeX API.\n\n\\end{document}",
"engine": "pdflatex"
}' \
--output hello.pdf\section{Cas d'usage}
Ce que les équipes construisent avec une API de génération de PDF
Rapports automatisés
Générez des rapports d'analyse mensuels, des synthèses financières ou des tableaux de bord opérationnels en PDF selon un calendrier, alimentés par des données en direct.
Factures et reçus
Compilez des factures professionnelles à partir des données de votre système de facturation. LaTeX gère avec précision les lignes à plusieurs colonnes, les totaux et les sections de taxes.
Certificats de réussite
Générez des certificats de réussite personnalisés pour les plateformes d'e-learning. Injectez dynamiquement les noms, les titres de cours et les dates.
Articles universitaires et thèses
Compilez des articles de recherche, des soumissions à des conférences et des thèses avec toute la mise en forme LaTeX : bibliographies, équations, figures, etc.
\section{FAQ}
Questions fréquentes
Faut-il connaître LaTeX pour utiliser FormaTeX ?
Le LaTeX de base est simple pour les documents courants. Le playground FormaTeX vous permet d'expérimenter de façon interactive. Pour les flux de travail assistés par IA, vous pouvez utiliser GPT-4 ou Claude pour générer le code source LaTeX : vous n'avez qu'à rédiger le prompt.
Quels moteurs LaTeX FormaTeX prend-il en charge ?
FormaTeX prend en charge pdflatex (le plus rapide, compatibilité maximale avec les paquets), xelatex (texte Unicode, polices OpenType) et lualatex (scripts Lua, typographie avancée). Indiquez votre moteur dans le corps de la requête.
Combien de temps dure la compilation ?
Les documents simples se compilent en moins d'une seconde. Les documents complexes comportant de nombreux paquets, des figures TikZ ou des bibliographies se compilent généralement en deux à cinq secondes.
Mon code source LaTeX est-il conservé après la compilation ?
Non. Votre code source LaTeX et le PDF compilé sont supprimés de nos serveurs immédiatement après l'envoi de la réponse HTTP. Rien n'est conservé.
Puis-je utiliser n'importe quel paquet CTAN ?
Oui. FormaTeX exécute une installation TeX Live complète. Tout paquet disponible sur CTAN l'est dans votre environnement de compilation, sans aucune configuration.
\section{Related}
Guides par langage
\end{pdf-api}
Commencez à générer des PDF via l'API
Créez un compte FormaTeX gratuit, récupérez votre clé API et compilez votre premier PDF avec une seule commande curl, sans carte bancaire.