Guida al prodotto e alle API

Integrazioni Make e Zapier

Prima di connetterti

Servono un account cliente PDFgine, un modello in quello spazio di lavoro, una quota di pagine disponibile e un account Make o Zapier. Crea prima il modello e annota il suo Template Code.

L’app Make è in fase di revisione per il catalogo. L’integrazione Zapier è privata. Contatta PDFgine per ottenere l’accesso; nessuna delle due integrazioni è ancora elencata pubblicamente.

Richiedi l’accesso all’integrazione

Connetti il tuo spazio di lavoro

Crea una chiave API dedicata nel tuo account PDFgine con usage:read e documents:render. Usa l’URL dell’API ospitata riportato sotto. Aggiungi templates:read solo se utilizzi il selettore facoltativo Brand Kit per le anteprime.

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

Il selettore Locale del connettore offre attualmente inglese e turco. La lingua del sito non modifica i dati del documento né i campi disponibili nel connettore.

Configura uno scenario Make

  1. Accetta l’accesso all’app privata fornito da PDFgine. Aggiungi un modulo PDFgine al tuo scenario e crea una connessione con l’URL dell’API e una chiave API dedicata.
  2. Scegli Create a Document, imposta Template Code e Format, quindi associa i valori del modulo precedente all’oggetto JSON Template Data. Usa Queue a Document per elaborazioni asincrone o Create a Public Preview per un link destinato al destinatario.
  3. Esegui Run once con dati di esempio e controlla il risultato del modulo e il documento generato. Attiva la pianificazione solo quando la mappatura è corretta. Make an API call supporta percorsi API relativi autorizzati; gli ambiti della connessione restano validi.

Configura uno Zap

  1. Accetta l’invito all’integrazione privata PDFgine nel tuo account Zapier. Scegli il trigger, aggiungi un’azione PDFgine e connettiti con l’URL dell’API e una chiave API dedicata.
  2. Per Create Document, imposta Template Code e Format, quindi associa i dati del trigger a Template Data come JSON valido. Queue Document e Create Public Preview sono azioni separate. Brand Kits è una fonte facoltativa per un menu a discesa, non un trigger.
  3. Prova l’azione, pubblica lo Zap e invia un nuovo evento trigger. Conferma un’esecuzione riuscita in Zap History e controlla il documento di quell’evento; un Test Step nell’editor, da solo, non dimostra che il flusso attivo sia stato eseguito.

Associa valori reali e mantieni valido il JSON

Template Data deve essere un oggetto JSON corrispondente ai campi del modello, non un percorso di file o un segnaposto vuoto. L’esempio seguente è per un modello di preventivo. Associa nomi e importi dal trigger, mantieni i valori numerici come numeri e verifica i totali calcolati prima dell’invio.

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
}

Scegli l’output giusto

Create Document restituisce una downloadUrl protetta che richiede l’autenticazione API. Per un link che il cliente possa aprire nel browser, usa Create Public Preview e scegli una durata di accesso consentita. Queue Document restituisce una statusUrl del processo; una risposta di accodamento non è un documento completato.

Generazione in coda · Link di anteprima

Prova prima di attivare

Usa prima dati cliente fittizi. Controlla destinatario, riferimento, voci, totali e formato di output. Dopo aver attivato il flusso, invia un nuovo evento e verifica la cronologia di esecuzione della piattaforma. Evita esecuzioni di produzione ripetute: le pagine generate consumano la quota PDFgine.

Limiti e risoluzione dei problemi

Per 401 o 403, controlla la connessione e gli ambiti API. Per 402, controlla la quota disponibile. Per 429, rispetta Retry-After e riduci la frequenza delle richieste. Correggi il JSON o i dati del modello non validi prima di riprovare. La durata delle anteprime e i limiti di generazione dipendono dal piano.

Errori · Leggi la quota

Mantieni riservate le chiavi di connessione

Inserisci la chiave API solo nelle impostazioni di connessione della piattaforma. Non includerla in Template Data, screenshot o registri di esecuzione condivisi. Usa una chiave separata per ogni connessione e revocala in PDFgine quando l’accesso non serve più.

Ti servono eventi dei documenti? Consulta la guida ai webhook API. Webhook