gPdf
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 vers PDF pour générer automatiquement des PDF dynamiques et en volume depuis vos systèmes.

Job to be done

Transformer les données métier en PDF prêts pour la production : étiquettes d'expédition, factures, rapports, certificats et documents clients générés depuis JSON dans votre application, sans demander aux utilisateurs de téléverser des fichiers dans un générateur PDF en ligne.

Why gPdf for this

  • Génération JSON vers PDF : décrivez pages, textes, images, tableaux, codes-barres et métadonnées dans un DocumentRequest structuré.
  • Flux API-first : appelez POST /api/v1/pdf/render depuis votre backend, un worker de jobs, un système d'entrepôt ou un produit SaaS.
  • Rendu prêt pour les lots : générez des milliers ou des millions de PDF sans gérer une flotte de navigateurs.
  • Polices intégrées pour les contenus latins, CJK, arabes, devanagari, bengalis, thaïs et cyrilliques.
  • Codes-barres vectoriels et formats fixes pour la logistique, l'e-commerce et les documents opérationnels.
  • Options PDF/A, métadonnées et facture électronique lorsque le document généré doit être archivé ou traité dans un cadre de conformité.

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 PDF générés doivent être archivés ou joints à des preuves d'audit.
  • Les métadonnées du document peuvent être définies directement dans la même requête, afin de conserver un titre, un auteur, un sujet et une langue stables.
  • Le même modèle structuré peut être utilisé depuis l'API ou 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 : permettre à vos propres logiciels de générer des PDF automatiquement.

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 passée et votre système doit générer une étiquette d’expédition.
  2. Un produit SaaS doit créer des relevés ou rapports mensuels.
  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 d’assistance doit produire un reçu, un certificat ou un export PDF à votre marque.

Dans tous ces cas, la bonne question n’est pas “quel bouton génère un PDF ?”. Elle devient : votre backend peut-il générer le bon PDF depuis les données, de manière répétée, rapide et économique ?

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 et codes-barres vectoriels,
  • les tableaux, métadonnées et paramètres du document,
  • les options PDF/A ou facture électronique lorsque nécessaire.

L’API renvoie un PDF. Pas de serveur navigateur à maintenir chaud, pas de version Chromium à verrouiller, pas de moteur de mise en page 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 les pistes d’audit,
  • une latence p99 stable lorsque la file monte,
  • un coût par page prévisible,
  • des polices et une géométrie de codes-barres qui ne changent pas avec les images de conteneur,
  • 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 de câbler le code. Pour l’intégration, utilisez la référence de la JSON Render API et envoyez la même requête depuis votre backend.

Si votre premier volume concerne la logistique, lisez aussi le cas d’usage des étiquettes d’expédition. Il applique le même modèle aux étiquettes thermiques 4×6, aux codes-barres transporteur et aux pics de génération en volume.

FAQ

gPdf est-il un générateur PDF en ligne classique ?
Non, pas au sens téléversement-conversion-téléchargement. gPdf est une API développeur pour générer automatiquement des PDF dans des produits, backends et systèmes opérationnels.
Peut-on générer des PDF 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 à une équipe opérations ou conception d'ajuster la mise en page pendant que les développeurs gardent le flux API.

Keep reading