# 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>