API di generazione PDF v1: senza stato

API di generazione PDF
dai modelli aziendali

Genera PDF dai tuoi modelli HTML, DOCX, Markdown o JSON. Zero conservazione dei dati: nessun documento o dato archiviato.

Ottieni la tua chiave API Guida rapida

4 formati di input

Sostituzione variabile

Zero archiviazione dei dati

SLA con tempo di attività del 99,9%.

Avvio rapido

Ottieni il tuo primo PDF in meno di 2 minuti. Crea una chiave API, invia una richiesta e scarica il risultato.

Ottieni la tua chiave API

Crea una chiave API dalla console sottostante o dalla dashboard.

La tua chiave API è segreta. Non esporlo mai nel codice frontend.

Invia la tua prima richiesta

Utilizza il seguente comando cURL per generare un PDF:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Scarica il tuo PDF

L'API restituisce il file binario PDF direttamente nel corpo della risposta.

Il PDF generato viene salvato nel file specificato nel flag --output.

Dimostrazione dal vivo

Prova l'API proprio qui: modifica il contenuto e le variabili, quindi premi Genera per visualizzare immediatamente il tuo PDF.

Accedi per provare la demo

Crea un account gratuito per accedere al parco giochi dal vivo e generare fino a 5 PDF dimostrativi.

Creare un account Registrazione

Console API

Gestisci le tue chiavi API e monitora l'utilizzo direttamente da questa pagina.

È richiesto l'accesso

Accedi per creare e gestire le tue chiavi API.

Creare un account Registrazione

Autenticazione

Tutte le richieste API richiedono una chiave API inviata tramite l'intestazione X-API-Key.

Come funziona

Crea una chiave API dalla console o dalla dashboard.
Includilo in ogni richiesta come intestazione X-API-Key.
L'API convalida la tua chiave e controlla la tua quota.
Le chiavi non valide o revocate restituiscono un errore 401.

Mantieni la tua chiave API al sicuro. Utilizzare variabili di ambiente, mai hardcoded nel codice sorgente.

Richiesta di esempio

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Risposta chiave non valida (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Formati di input

EasyPDF supporta 4 formati di input. Scegli quello che meglio si adatta al tuo flusso di lavoro.

HTML

Supporto CSS completo, pixel perfetto tramite Chromium

DOCX

Carica modelli Word con segnaposto variabili

Markdown

5 temi integrati per bellissimi documenti

Template JSON

Motore Canvas per un controllo preciso del layout

HTML→PDF

Il più popolare

Invia qualsiasi HTML con CSS in linea. Il motore di rendering di Chromium garantisce che l'output corrisponda perfettamente alla visualizzazione del browser.

Caratteristiche principali

Supporto completo CSS3 (Flexbox, Grid, query multimediali)
Intestazioni e piè di pagina personalizzati con numeri di pagina
Sostituzione di variabile con sintassi {{variable}}
Layout reattivi con dimensioni pagina A4/Letter/Legal

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

Endpoint API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Genera un PDF da contenuti HTML, Markdown o Template JSON.

Request Body (JSON)

Parametro	Tipa	Necessaria	Descrizione
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	Stringa di contenuto HTML o Markdown (richiesto per html/markdown)
`template_data`	`object`	Yes*	Oggetto JSON modello (richiesto per il formato modello)
`variables`	`object`	No	Coppie chiave-valore per la sostituzione di variabili
`options`	`object`	No	Opzioni di generazione PDF (formato pagina, margini, ecc.)

Risposta

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Carica un file DOCX per la conversione in PDF con sostituzione variabile opzionale.

Form Fields

Field	Tipa	Necessaria	Descrizione
`file`	File	Yes	Il file .docx da convertire
`variables`	string (JSON)	No	Coppie chiave-valore per la sostituzione di variabili
`options`	string (JSON)	No	Opzioni PDF come stringa JSON

POST/generate/previewAPI Key

Genera un'anteprima PNG della prima pagina invece di un PDF completo.

200Content-Type: image/png

GET/usageAPI Key

Controlla l'utilizzo mensile corrente e la quota rimanente.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Crea una nuova chiave API (richiede l'autenticazione JWT).

GET/keysJWT Bearer

Elenca tutte le tue chiavi API con le statistiche di utilizzo.

DELETE/keys/:key_idJWT Bearer

Revoca (disattiva) una chiave API in modo permanente.

Esempi di codici

Esempi completi e pronti all'uso nella lingua e nel formato preferiti. Seleziona una lingua e un formato di input di seguito.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Casi d'uso

Scopri come i team utilizzano l'API EasyPDF per automatizzare la generazione di documenti su larga scala.

Fatture e ricevute

Genera fatture brandizzate con voci dinamiche, totali e dettagli del cliente.

HTML / DOCX

Contratti e accordi

Compila i modelli Word con i dati del cliente e convertili in PDF per la firma.

DOCX

Certificati e diplomi

Crea certificati personalizzati con layout e posizionamento precisi.

Template JSON

Report e dashboard

Trasforma i dati Markdown o HTML in report PDF raffinati.

Markdown / HTML

Lettere e invii

Genera lettere personalizzate da modelli DOCX per invii di massa.

DOCX

Documenti di conformità

Produci documenti di conformità a prova di manomissione e pronti per l'audit.

HTML

Opzioni PDF

Personalizza l'output con questi parametri facoltativi nell'oggetto opzioni.

Option	Tipa	Predefinita	Descrizione
`page_format`	`string`	`"A4"`	Formato pagina: A4, Lettera, Legale, Tabloid o personalizzato
`landscape`	`boolean`	`false`	Abilita l'orientamento orizzontale
`margin_top`	`string`	`"20mm"`	Margine superiore (unità CSS: mm, cm, pollici, px)
`margin_bottom`	`string`	`"20mm"`	Margine inferiore
`margin_left`	`string`	`"15mm"`	Margine sinistro
`margin_right`	`string`	`"15mm"`	Margine destro
`header_html`	`string`	`null`	Contenuto HTML per l'intestazione della pagina
`footer_html`	`string`	`null`	Contenuto HTML per il piè di pagina (supporta pageNumber, totalPages)
`theme`	`string`	`"modern"`	Tema Markdown: moderno, classico, minimale, github, accademico

Esempio di opzioni complete

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Gestione degli errori

L'API restituisce errori JSON strutturati con codici di errore coerenti.

Formato della risposta all'errore

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Quando	Cosa fare
`400`	`missing_content`	Campo obbligatorio mancante	Controlla i campi del corpo della richiesta
`400`	`invalid_json`	Analisi JSON non riuscita	Convalida il tuo payload JSON
`400`	`unsupported_format`	Valore formato sconosciuto	Utilizza HTML, markdown o modello
`401`	`invalid_api_key`	Chiave API non trovata	Verifica l'intestazione X-API-Key
`402`	`quota_exceeded`	Quota mensile superata	Aggiorna il tuo piano o attendi il ripristino
`403`	`api_key_revoked`	La chiave è stata revocata	Crea una nuova chiave API
`429`	`rate_limit_exceeded`	Limite di velocità raggiunto	Attendere e riprovare con backoff esponenziale
`500`	`generation_failed`	Errore di elaborazione interna	Controlla la presenza di errori nei tuoi contenuti e riprova

Limiti tariffari e quote

Ciascun piano prevede una quota PDF mensile e un limite di velocità al minuto.

Limitazione della velocità

Le richieste che superano il limite di velocità ricevono una risposta 429 con un'intestazione Retry-After.

Risposta a velocità limitata

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Quote mensili

L'utilizzo si reimposta il 1° di ogni mese a mezzanotte UTC.

Plan	PDFs/mese	Rate limit	Prezzo	Eccesso
Starter	500	10/min	9€/mese	0,02€/PDF
Business	5 000	30/min	79€/mese	0,01€/PDF
Enterprise	Costume	Costume	Su preventivo	Negoziabile

Migliori pratiche

Segui questi consigli per ottenere il massimo dall'API.

Utilizza le variabili per i contenuti dinamici

Mantieni i tuoi modelli statici e inserisci i dati tramite l'oggetto variabili. Questo è più efficiente della ricostruzione dell'HTML a ogni chiamata.

Gestisci gli errori con garbo

Controlla sempre il codice di stato HTTP. Implementa nuovi tentativi con backoff esponenziale per gli errori 429 e 5xx.

Ottimizza i tuoi modelli

Riduci al minimo i CSS, evita risorse esterne (incorporatele) e testa i modelli prima di distribuirli in produzione.

Monitora il tuo utilizzo

Utilizza l'endpoint /usage o la console sopra per monitorare il consumo ed evitare limiti di quota imprevisti.

Proteggi le tue chiavi API

Memorizza le chiavi in variabili di ambiente o gestori di segreti. Ruota periodicamente le chiavi e revoca quelle non utilizzate.

Prezzi

Prezzi semplici e trasparenti. Paghi solo per quello che usi.

Starter

9€/mese

~0,018€ / PDF

500 PDFs / mese
10 richieste/min
Tutti e 4 i formati di input
Generazione di anteprime PNG
Supporto via e-mail
Eccesso : 0,02€/PDF

Inizia

Miglior rapporto qualità/prezzo

Business

79€/mese

~0,016€ / PDF

5 000 PDFs / mese
30 richieste/min
Tutte le funzionalità di Starter
Supporto prioritario
Dashboard di analisi dell'utilizzo
Eccesso : 0,01€/PDF