Vai al contenuto
Menu della documentazione

Guida rapida

Da un nuovo account al tuo primo PDF generato tramite API: collega, interroga, progetta, pubblica, genera.

Questa guida ti accompagna da un nuovo account al PDF di una fattura generato tramite API. Ti servono un database Oracle o PostgreSQL raggiungibile e circa quindici minuti. Gli stessi passi valgono per qualsiasi altro documento: DDT, etichette, certificati, report.

  1. Crea un account

    Crea un account, apri il link di verifica che ti inviamo via email, poi accedi. Il tuo workspace parte con un ambiente di development, dove puoi fare prove in libertà.

  2. Collega un database

    In Sorgenti dati, scegli Nuova sorgente dati, poi Oracle (o PostgreSQL). Inserisci host, porta e service name (per PostgreSQL il nome del database) e le credenziali di un utente che possa leggere le tabelle necessarie ai tuoi documenti. Usa Prova la connessione prima di salvare.

    Oracle · utente in sola lettura consigliato
    -- Un utente dedicato a Prynt, in sola letturaCREATE USER prynt_reader IDENTIFIED BY "<una password robusta>";GRANT CREATE SESSION TO prynt_reader;GRANT SELECT ON erp.invoices      TO prynt_reader;GRANT SELECT ON erp.invoice_lines TO prynt_reader;GRANT SELECT ON erp.customers     TO prynt_reader;

    Le credenziali restano protette

    Le password sono cifrate a riposo e non vengono mai rimandate al browser. I dataset possono solo leggere: le istruzioni che modificano i dati vengono rifiutate.

  3. Crea un template

    In Template, scegli Nuovo template, formato Documento PDF, codice invoice e formato pagina A4. Il codice è il modo in cui la tua applicazione si riferisce al template: tienilo breve e stabile.

  4. Aggiungi un dataset

    Apri il pannello Dataset e scrivi la query del documento. Ogni bind variable diventa un parametro del template: qui :invoiceId crea il parametro invoiceId. Assegnagli un valore di prova ed esegui la query per vederne i campi.

    Dataset INVOICE
    SELECT i.invoice_no, i.issue_date, c.name AS customer_name,       l.description, l.quantity, l.amount  FROM erp.invoices i  JOIN erp.customers c      ON c.id = i.customer_id  JOIN erp.invoice_lines l  ON l.invoice_id = i.id WHERE i.id = :invoiceId ORDER BY l.line_no

  5. Progetta il layout

    Trascina i campi dal pannello Dati sulla pagina: i campi di testata nell'intestazione di pagina, i campi delle righe in una tabella nel corpo. Aggiungi i totali, un logo e un codice a barre con il numero della fattura. Premi F5 in qualsiasi momento per un'anteprima PDF reale con i valori di prova.

  6. Pubblica

    Pubblica valida il template e crea la versione 1, che non potrà più cambiare. La bozza resta modificabile per la versione successiva. Promuovi la versione nell'ambiente usato dalla tua applicazione.

  7. Crea una chiave API

    In Sviluppatori → Chiavi API, crea una chiave per l'ambiente. La chiave completa viene mostrata una sola volta: conservala come segreto nella configurazione della tua applicazione, mai nel codice eseguito dal browser né nel controllo di versione.

  8. Genera il documento

    Chiama l'endpoint di generazione con il codice del template e i suoi parametri. Il corpo della risposta è il PDF.

    Terminale
    curl -X POST https://api.prynt.it/api/v1/render \  -H "Authorization: Bearer prynt_live_..." \  -H "Content-Type: application/json" \  -d '{    "template": "invoice",    "environment": "production",    "parameters": { "invoiceId": 18425 }  }' \  -o invoice-18425.pdf

    Una chiamata riuscita risponde 200 OK con Content-Type: application/pdf. In caso di errore la risposta è un problem document; vedi errori.

Prossimi passi