Documentazione di PDF Blocks

Ogni azione segue lo stesso modello: inviare un documento, indicare cosa farne e ricevere subito indietro il documento finito. Non c’è alcun SDK da installare né alcuno stato da gestire, e non viene conservato nulla una volta inviata la risposta.

Conviene iniziare dal modo in cui si intende chiamarla, oppure cercare tra tutte le pagine dall’intestazione (⌘K, o Ctrl K su Windows).

Scegliere l’integrazione#

API

Per scrivere codice, in qualsiasi linguaggio.

Una chiamata HTTPS autenticata per azione: multipart/form-data in entrata, un PDF in uscita. Tutte le azioni sono disponibili, e ogni output è un input valido per quella successiva.

Avvio rapidoAzioni

Power Automate

Per creare un flusso in Power Automate.

Il nostro connettore certificato, con tutte e diciassette le azioni come passaggi del flusso. I documenti passano da un passaggio all’altro come contenuto del file, quindi non serve alcuna memorizzazione intermedia.

Per iniziareModelli

Zapier

Per collegare tra loro le applicazioni senza codice.

Le azioni più comuni come passaggi di uno Zap, che prendono i file dalle applicazioni già collegate. Conviene partire da qui per le regole sui campi file, sulle quali inciampa la maggior parte degli Zap.

Per iniziareCampi file

Provare una richiesta#

Mettere un PDF di nome input.pdf nella directory di lavoro, sostituire la propria chiave ed eseguire questo esempio. Appone una filigrana sul documento e scrive il risultato in watermarked.pdf.

curl https://api.pdfblocks.com/v1/add_text_watermark \
  -H 'X-API-Key: your_api_key' \
  -F file=@input.pdf \
  -F line_1='CONFIDENTIAL' \
  -o watermarked.pdf

La risposta è 200 OK con application/pdf e il documento finito come corpo. Ogni azione a output singolo segue la stessa forma, quindi cambiare il nome dell’azione è quasi tutto il lavoro necessario per adottare la successiva. L’Avvio rapido riporta la stessa chiamata in Python, Node.js, PHP, Ruby e altri linguaggi, oltre a come ottenere una chiave.

Cosa si può fare#

Diciassette azioni, raggruppate per funzionalità. Ogni gruppo rimanda al catalogo completo, dove ogni azione ha la propria pagina di riferimento.

Concetti fondamentali#

Valgono per ogni azione, ed è qui che trova risposta la maggior parte delle domande sull’integrazione.

• Autenticazione: come funzionano le chiavi API, cosa inviare a ogni richiesta e come tenere al sicuro una chiave.
• Lavorare con i file: come inviare i documenti, i limiti di dimensione e cosa viene restituito.
• Selezionare le pagine: la sintassi di intervalli pages condivisa da tutte le azioni che operano sulle pagine.
• Concatenare le azioni: passare l’output di un’azione a quella successiva senza mai toccare il disco.
• Formati di risposta: la negoziazione del contenuto e come rispondono le azioni che producono più documenti.
• Errori: il corpo dell’errore e il significato di ogni codice di stato.
• Rate limit e utilizzo: cosa conta come richiesta e cosa succede al raggiungimento di un limite.
• Regioni e residenza dei dati: gli endpoint regionali e dove ciascuno elabora i documenti.
• Versionamento e stabilità: cosa può cambiare sotto un’integrazione già in funzione e cosa no.

Sicurezza e conformità#

Due fatti strutturali determinano la maggior parte delle domande di una verifica: i documenti non vengono mai memorizzati e nessun LLM li legge. Ogni file viene elaborato in memoria e restituito nella stessa risposta.

La sezione Fiducia ne riporta il dettaglio: la Panoramica sulla sicurezza con una mappatura dei controlli su SOC 2, HIPAA e le condizioni del BAA, l’elenco dei sub-responsabili e i documenti legali (Termini e condizioni, Informativa sulla privacy e Addendum sul trattamento dei dati).

Riferimenti e supporto#