/01
À quelle vitesse gPdf rend-il un PDF ?
Le p50 est de 3 ms et le p99 de 8 ms — mesurés sur 1000 appels pour une seule page A4. Le temps total en périphérie, réseau inclus, est typiquement de 8 à 15 ms.
FAQ
Les questions que les développeurs posent vraiment.
Douze réponses — citées textuellement par le JSON-LD FAQPage que les Google rich results consomment.
/02
Quel format d'entrée l'API accepte-t-elle ?
Un corps DocumentRequest en JSON. Pages, éléments, calques, filigranes, en-têtes, pieds de page et tableaux sont tous exprimés de manière structurelle — pas de HTML, pas de Markdown, pas de passe de mise en page navigateur.
/03
Comment gPdf se compare-t-il à Puppeteer ou Chrome headless ?
Chromium headless tourne à 200 à 800 ms par rendu et nécessite un conteneur de 800 Mo. gPdf rend la même page A4 en 3 ms dans un isolate V8 de 1 Mo, sans démarrage à froid. Le compromis est le format d'entrée : gPdf prend un DocumentRequest JSON, pas du HTML brut.
/04
Quels sont les endpoints de l'API gPdf ?
Trois : /api/v1/pdf/render prend un DocumentRequest complet pour un contrôle au pixel près. /api/v1/template-render prend template_id plus un tableau de données pour les systèmes avec un template publié. /api/v1/e-invoice/render produit des factures hybrides Factur-X / ZUGFeRD (PDF/A-3 + XML intégré). Les trois partagent le même moteur, les mêmes limites de débit et la même surface de codes d'erreur.
/05
Dois-je installer des polices sur mon serveur pour le chinois, le japonais ou le coréen ?
Non. NotoSans CJK est intégré, et une chaîne de repli automatique gère les glyphes manquants. Vous ne verrez jamais de carrés tofu, et vous n'avez pas besoin d'apt install fonts-noto-cjk sur votre runtime.
/06
Quels codes-barres puis-je rendre ?
Plus de 30 symbologies dont QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode et Code 128. Tous vectoriels. La longueur totale du code-barres est précise à 0,1 mm près de la taille demandée — assez serré pour les largeurs d'étiquettes spécifiées GS1 et ITF-14.
/07
gPdf produit-il une sortie PDF/A ou conforme aux factures électroniques ?
Oui. PDF/A-1b, 2b, 3b et 4 sont sélectionnables par requête. Les flux d'attachement Factur-X et ZUGFeRD sont pris en charge pour les scénarios de facturation électronique.
/08
gPdf peut-il produire des factures Factur-X, ZUGFeRD ou EN 16931 ?
Oui. Réglez settings.profile sur pdfa-3b et attachez la charge XML structurée comme flux de fichier. Factur-X et ZUGFeRD reposent sur PDF/A-3 — requis pour le mandat français de facturation électronique B2B à partir de septembre 2026, et le mandat allemand déjà en vigueur.
/09
Où s'exécute réellement gPdf ?
Dans des isolates V8 Cloudflare Workers. Pas de conteneur Chromium, pas de réchauffement Lambda, et pas de persistance de document après la requête.
/10
gPdf stocke-t-il mes PDF ou mes données d'entrée ?
Non. Le moteur de rendu est sans état. Votre DocumentRequest vit dans un isolate V8 pendant les quelques millisecondes du rendu, puis disparaît. gPdf n'a ni couche de cache ni stockage de documents — l'absence d'état est le contrat, pas une option.
/11
Y a-t-il un palier gratuit ?
Oui. La version d'essai gratuite offre 100 pages par jour, sans carte bancaire. Elle se réinitialise quotidiennement et s'arrête au quota — aucune facture surprise. Les paliers payants commencent à 5 $ par mois pour 100 000 pages.
/12
Comment commencer à utiliser gPdf ?
Ouvrez le playground ci-dessus, modifiez le DocumentRequest, puis cliquez sur Générer le PDF — le worker edge en direct renvoie un vrai PDF. Copiez l'extrait curl dans votre terminal pour l'appeler depuis n'importe où. Le playground ne nécessite ni installation ni carte bancaire ; un compte n'est requis que pour émettre votre propre clé API.