gPdf render/edge
Use cases · API de génération de PDF

API de génération de PDF pour documents métier dynamiques

Vous cherchez un générateur PDF ? gPdf est une API JSON-to-PDF pour générer automatiquement des PDFs dynamiques et en volume depuis vos systèmes.

Job to be done

Transformer les données métier en PDFs prêts à être livrés : étiquettes d'expédition, factures, rapports, certificats et documents clients générés automatiquement depuis du JSON dans votre application, sans upload manuel ni export fichier par fichier.

Why gPdf for this

  • Génération JSON-to-PDF : décrivez pages, textes, images, tableaux, codes-barres et métadonnées dans un DocumentRequest structuré.
  • Workflow API-first : appelez POST /api/v1/pdf/render depuis votre backend, une file de jobs, un WMS ou un produit SaaS.
  • Conçu pour le volume : générez des milliers ou millions de PDFs sans exploiter une flotte de navigateurs headless.
  • Polices intégrées pour les contenus Latin, CJK, arabes, devanagari, bengalis, thaïs et cyrilliques.
  • Codes-barres vectoriels et formats fixes pour la logistique, l'ecommerce et les documents opérationnels.
  • Options PDF/A, métadonnées et e-invoice lorsque le document doit être archivé ou auditable.

Sample request

POST /api/v1/pdf/render : un PDF dynamique minimal généré depuis JSON.

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

Compliance and conformance

  • Les profils PDF/A sont disponibles lorsque les PDFs générés doivent être archivés ou joints à un dossier d'audit.
  • Les métadonnées peuvent être définies dans la même requête afin de stabiliser le titre, l'auteur, le sujet et la langue du document.
  • Le même modèle structuré fonctionne dans l'API et dans l'éditeur visuel sur https://studio.gpdf.com.

Si vous avez seulement besoin d’un générateur PDF ponctuel

Pour convertir un document Word, fusionner deux fichiers ou exporter une page une fois, un outil en ligne classique suffit. Il est conçu pour un geste manuel : téléverser, cliquer, télécharger.

gPdf répond à un autre besoin : faire générer les PDFs par votre application, automatiquement et de manière fiable.

Quand “générateur PDF” veut dire API de génération de PDF

La recherche est souvent large, mais le besoin réel devient très concret côté produit :

  1. Une commande est créée et le système doit produire l’étiquette transporteur.
  2. Un SaaS doit générer des rapports périodiques pour chaque client.
  3. Une équipe finance veut des factures avec métadonnées stables et options d’archivage.
  4. Un entrepôt doit sortir des dizaines de milliers d’étiquettes avant l’enlèvement.
  5. Un outil support doit exporter reçus, attestations ou dossiers au format PDF.

La question n’est plus quel bouton crée un PDF. Elle devient : votre backend peut-il produire le bon document depuis les données, à répétition, vite et avec un coût prévisible ?

Le modèle gPdf : JSON en entrée, PDF en sortie

gPdf repose sur un modèle JSON structuré. Votre application envoie :

  • le format de page et les coordonnées,
  • les blocs de texte et les polices,
  • les images, tableaux et codes-barres vectoriels,
  • les métadonnées et paramètres du document,
  • les options PDF/A ou e-invoice lorsque nécessaire.

L’API renvoie le PDF. Pas de serveur Chromium à maintenir chaud, pas de version de navigateur à verrouiller, pas de moteur HTML/CSS dans le chemin critique.

Pourquoi c’est important pour la génération en volume

Un générateur PDF généraliste est pratique pour une personne. Il n’est pas conçu pour un système qui produit des documents toute la journée.

En génération par lots, les critères importants sont :

  • un rendu déterministe pour les réimpressions et audits,
  • une latence p99 stable lorsque la file monte,
  • un coût par page prévisible,
  • des polices et codes-barres cohérents entre environnements,
  • une requête JSON que l’on peut versionner, tester et restaurer.

C’est précisément la charge que vise gPdf.

Commencer par un appel simple

Ouvrez le Playground pour tester le modèle JSON avant l’intégration. Pour brancher le backend, utilisez la référence de la JSON Render API.

Si votre premier cas concerne la logistique ou l’ecommerce, lisez aussi quand gPdf convient à la génération de PDFs pour la logistique et l’ecommerce.

FAQ

gPdf est-il un générateur PDF en ligne classique ?
Non, pas au sens upload-conversion-téléchargement. gPdf est une API destinée aux produits, backends et systèmes opérationnels qui génèrent des PDFs automatiquement.
Peut-on générer des PDFs dynamiques depuis JSON ?
Oui. Un DocumentRequest décrit les pages, textes, images, codes-barres, tableaux, métadonnées et paramètres. Votre application envoie du JSON et reçoit un PDF.
Quand choisir gPdf plutôt qu'un navigateur headless ?
Choisissez gPdf pour des documents structurés, répétitifs et volumineux : étiquettes, factures, rapports, certificats et documents métier. Un navigateur reste utile pour capturer du HTML arbitraire.
Une équipe non technique peut-elle travailler sur la mise en page ?
Oui. L'éditeur visuel sur https://studio.gpdf.com utilise le même modèle JSON, ce qui permet aux équipes opérations ou design d'ajuster le layout pendant que les développeurs gardent le workflow API.

Keep reading