Guide du produit et de l’API

Intégrations Make et Zapier

Avant la connexion

Vous avez besoin d’un compte client PDFgine, d’un modèle dans cet espace de travail, d’un quota de pages disponible et d’un compte Make ou Zapier. Créez d’abord votre modèle et notez son Template Code.

L’application Make est en cours d’examen pour le catalogue. L’intégration Zapier est privée. Contactez PDFgine pour y accéder ; aucune des deux intégrations n’est encore référencée publiquement.

Demander l’accès à l’intégration

Connectez votre espace de travail

Créez une clé API dédiée dans votre compte PDFgine avec usage:read et documents:render. Utilisez l’URL de l’API hébergée ci-dessous. Ajoutez templates:read uniquement si vous utilisez le sélecteur facultatif Brand Kit pour les aperçus.

https://api.pdfgine.com · usage:read · documents:render

Le sélecteur Locale du connecteur propose actuellement l’anglais et le turc. La langue du site ne modifie ni les données du document ni les champs disponibles dans le connecteur.

Configurer un scénario Make

  1. Acceptez l’accès à l’application privée fourni par PDFgine. Ajoutez un module PDFgine à votre scénario et créez une connexion avec votre URL d’API et une clé API dédiée.
  2. Choisissez Create a Document, définissez Template Code et Format, puis associez les valeurs du module précédent à l’objet JSON de Template Data. Utilisez Queue a Document pour les traitements asynchrones ou Create a Public Preview pour un lien destiné au destinataire.
  3. Exécutez Run once avec des données d’exemple et vérifiez le résultat du module ainsi que le document généré. N’activez la planification qu’une fois les correspondances correctes. Make an API call prend en charge les chemins API relatifs autorisés ; les portées de la connexion restent applicables.

Configurer un Zap

  1. Acceptez l’invitation à l’intégration privée PDFgine dans votre compte Zapier. Choisissez votre déclencheur, ajoutez une action PDFgine et connectez-vous avec votre URL d’API et une clé API dédiée.
  2. Pour Create Document, définissez Template Code et Format, puis associez les données du déclencheur à Template Data sous forme de JSON valide. Queue Document et Create Public Preview sont des actions distinctes. Brand Kits est une source facultative de liste déroulante, pas un déclencheur.
  3. Testez l’action, publiez le Zap et envoyez un nouvel événement déclencheur. Confirmez une exécution réussie dans Zap History et vérifiez le document de cet événement ; un Test Step dans l’éditeur ne prouve pas, à lui seul, que le flux actif s’est exécuté.

Associez des valeurs réelles et gardez un JSON valide

Template Data doit être un objet JSON correspondant aux champs de votre modèle, et non un chemin de fichier ou une valeur vide de substitution. L’exemple ci-dessous concerne un modèle de devis. Associez les noms et montants du déclencheur, conservez les valeurs numériques sous forme de nombres et vérifiez les totaux calculés avant l’envoi.

JSON 
{
  "document": { "title": "DEMO ONLY" },
  "referenceNo": "DEMO-001",
  "issueDate": "2026-10-27",
  "currency": "USD",
  "customer": "Demo Customer",
  "quoteItems": [
    { "name": "Demo service", "quantity": 2, "unitPrice": 50, "total": 100 }
  ],
  "subtotal": 100,
  "vatAmount": 20,
  "grandTotal": 120
}

Choisissez la bonne sortie

Create Document renvoie une downloadUrl protégée qui nécessite une authentification API. Pour un lien consultable par le client dans son navigateur, utilisez Create Public Preview et choisissez une durée d’accès autorisée. Queue Document renvoie une statusUrl de tâche ; une réponse indiquant la mise en file n’est pas un document terminé.

Rendu en file d’attente · Liens d’aperçu

Testez avant d’activer

Utilisez d’abord des données clients fictives. Vérifiez le destinataire, la référence, les lignes, les totaux et le format de sortie. Après activation du flux, envoyez un nouvel événement et vérifiez l’historique d’exécution de la plateforme. Évitez les exécutions de production répétées : les pages générées consomment votre quota PDFgine.

Limites et dépannage

Pour les erreurs 401 ou 403, vérifiez la connexion et les portées API. Pour une erreur 402, vérifiez le quota disponible. Pour une erreur 429, respectez Retry-After et réduisez la fréquence des requêtes. Corrigez le JSON ou les données de modèle invalides avant de réessayer. La durée d’aperçu et les limites de génération dépendent de votre offre.

Erreurs · Consulter votre quota

Gardez les clés de connexion confidentielles

Saisissez votre clé API uniquement dans les paramètres de connexion de la plateforme. Ne la placez pas dans Template Data, des captures d’écran ou des journaux d’exécution partagés. Utilisez une clé distincte pour chaque connexion et révoquez-la dans PDFgine lorsque l’accès n’est plus nécessaire.

Besoin d’événements sur les documents ? Consultez le guide des webhooks API. Webhooks