# Introduzione all’API PDF Blocks Che cos’è PDF Blocks, il modello che segue ogni azione e il catalogo di tutto ciò che l’API sa fare. PDF Blocks è un’API HTTP sicura, veloce e *stateless* per lavorare con i documenti PDF. Inviare un documento, indicare un’azione e riavere il PDF elaborato direttamente nella risposta. Non c’è nessuno stato dell’account da gestire, non viene memorizzato nulla una volta conclusa la richiesta e non c’è nessun SDK da installare: ogni azione è una singola chiamata HTTPS autenticata, eseguibile da qualsiasi linguaggio. ## Il modello mentale Un PDF in input, un PDF in output. Ogni azione è una trasformazione pura: riceve un documento (più qualche parametro), restituisce un nuovo documento e non conserva nulla. Si invia `multipart/form-data` con il proprio PDF in un campo `file` e un’azione a output singolo risponde `200 OK` con `application/pdf`, il documento finito come corpo della risposta. Poiché ogni output è a sua volta un PDF valido, è un input valido per l’azione successiva. Le azioni sono quindi componibili: unire più file, apporre una filigrana sul risultato e poi crittografarlo, ogni passaggio alimenta il successivo. Vedere [Concatenare le azioni](/docs/api/chaining-actions) per costruire una pipeline senza mai toccare il disco. ## Il catalogo delle azioni Diciassette azioni, raggruppate per funzionalità. Ognuna rimanda al proprio riferimento completo. ### Unione e divisione <CardGroup cols={3}> <Card title="Unire documenti" href="/docs/api/merge-pdf-documents"> Unire un elenco ordinato di PDF in un unico documento. </Card> <Card title="Dividere per numero di pagine" href="/docs/api/split-pdf-by-page-count"> Dividere in blocchi di dimensione fissa. </Card> <Card title="Dividere a una pagina" href="/docs/api/split-pdf-at-page"> Dividere a un punto di taglio scelto. </Card> <Card title="Dividere per dimensione" href="/docs/api/split-pdf-by-file-size"> Limitare la dimensione in byte di ogni parte. </Card> <Card title="Dividere in gruppi di pagine" href="/docs/api/split-pdf-into-page-groups"> Raggruppare le pagine secondo uno schema che si definisce. </Card> </CardGroup> ### Filigrane <CardGroup cols={3}> <Card title="Aggiungere una filigrana di testo" href="/docs/api/add-text-watermark-to-pdf"> Apporre fino a tre righe di testo. </Card> <Card title="Aggiungere una filigrana immagine" href="/docs/api/add-image-watermark-to-pdf"> Apporre un logo o un’immagine. </Card> </CardGroup> ### Password e sicurezza <CardGroup cols={3}> <Card title="Aggiungere una password" href="/docs/api/add-password-to-pdf"> Crittografare un documento. </Card> <Card title="Rimuovere la password" href="/docs/api/remove-password-from-pdf"> Decrittografare un documento di cui si conosce la password. </Card> <Card title="Aggiungere restrizioni" href="/docs/api/add-restrictions-to-pdf"> Impostare i flag di autorizzazione. </Card> <Card title="Rimuovere le restrizioni" href="/docs/api/remove-restrictions-from-pdf"> Azzerare i flag di autorizzazione. </Card> <Card title="Rimuovere le firme" href="/docs/api/remove-signatures-from-pdf"> Rimuovere le firme digitali. </Card> </CardGroup> ### Pagine <CardGroup cols={3}> <Card title="Estrarre pagine" href="/docs/api/extract-pages-from-pdf"> Conservare un sottoinsieme di pagine. </Card> <Card title="Rimuovere pagine" href="/docs/api/remove-pages-from-pdf"> Scartare un sottoinsieme di pagine. </Card> <Card title="Ruotare le pagine" href="/docs/api/rotate-pages-in-pdf"> Ruotare le pagine di 90°, 180° o 270°. </Card> <Card title="Invertire le pagine" href="/docs/api/reverse-pages-of-pdf"> Invertire l’ordine delle pagine. </Card> <Card title="Riordinare le pagine" href="/docs/api/reorder-pages-of-pdf"> Riorganizzare le pagine in qualsiasi ordine. </Card> </CardGroup> Per il quadro completo, con la convenzione di denominazione, il modo in cui le azioni si compongono e il punto in cui ciascuna è documentata, vedere la [Panoramica delle azioni](/docs/api/actions-overview). ## Che cosa la distingue - **Veloce.** Le azioni sono trasformazioni a scopo unico, senza code e senza andate e ritorni. Si invia una richiesta e si scrive il risultato in streaming direttamente su un file. - **Sicura e stateless.** Le richieste viaggiano solo su HTTPS e si autenticano con una chiave segreta. I documenti vengono elaborati nella regione scelta e non vengono mai memorizzati: una volta scritta la risposta, non resta nulla. - **Residenza regionale dei dati.** Lo stesso catalogo gira in dieci regioni, così i documenti possono essere elaborati dove la conformità lo richiede. Basta puntare una richiesta all’URL di base della regione e tutto il resto è identico. | Regione | URL di base | | ----------------- | --------------------------------- | | Globale | `https://api.pdfblocks.com` | | Stati Uniti | `https://us.api.pdfblocks.com` | | HIPAA Stati Uniti | `https://hipaa.api.pdfblocks.com` | | Unione europea | `https://eu.api.pdfblocks.com` | | Regno Unito | `https://uk.api.pdfblocks.com` | | Canada | `https://ca.api.pdfblocks.com` | | Australia | `https://au.api.pdfblocks.com` | | Giappone | `https://jp.api.pdfblocks.com` | | India | `https://in.api.pdfblocks.com` | | Brasile | `https://br.api.pdfblocks.com` | Vedere [Regioni e residenza dei dati](/docs/api/regions-and-data-residency) per tutti i dettagli. ## Come proseguire <CardGroup cols={2}> <Card title="Avvio rapido" href="/docs/api/quickstart"> Eseguire la prima chiamata autenticata e avere in mano un PDF elaborato in cinque minuti. </Card> <Card title="Autenticazione" href="/docs/api/authentication"> Ottenere una chiave API e inviarla correttamente a ogni richiesta. </Card> </CardGroup>