# Regioni e residenza dei dati

Gli URL di base regionali a cui inviare le richieste, quali piani raggiungono quali regioni e che cosa significa che l’elaborazione resta in una sola regione.

Ogni azione di PDF Blocks viene eseguita nella regione a cui ci si rivolge. Basta
scegliere un URL di base e il documento viene elaborato lì e in nessun altro
luogo. Scegliere una regione è semplice come sostituire l’host nell’URL. Ogni
regione esegue il catalogo completo di 17 azioni, con la stessa disponibilità.

## Endpoint regionali

Inviare la richiesta all’URL di base della regione in cui si vuole che avvenga
l’elaborazione.

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

Tutte le regioni qui sopra sono attive, servono il catalogo completo delle azioni
e godono dello stesso impegno di disponibilità. L’endpoint **Globale** instrada
ogni richiesta verso l’infrastruttura più vicina, per la latenza più bassa; gli
endpoint regionali con nome vincolano l’elaborazione a una giurisdizione precisa.

## Disponibilità delle regioni per piano

Le regioni a cui ci si può rivolgere dipendono dal piano:

- **Free**: Globale.
- **Starter**: Globale, Stati Uniti ed Europa.
- **Business**: tutte le regioni qui sopra.

Vedere i [prezzi](/pricing) per il dettaglio completo.

## Che cosa significa «l’elaborazione resta nella regione»

Una richiesta inviata a un URL di base regionale viene elaborata interamente
all’interno di quella regione. L’upload viene ricevuto, trasformato e
restituito da un’infrastruttura di quella giurisdizione. Non viaggia altrove per
essere elaborato.

Poiché l’API è **stateless**, non c’è nulla da memorizzare: il documento esiste
solo in memoria per la durata della richiesta. Una volta restituita la risposta
in streaming, l’input e l’output non ci sono più; nessun bucket, database o coda
conserva i file dopo il completamento della chiamata. La residenza dei dati si
riduce quindi a una sola decisione: a quale host si invia la richiesta.

## L’endpoint HIPAA Stati Uniti

`https://hipaa.api.pdfblocks.com` è un endpoint negli Stati Uniti gestito per i
flussi di lavoro che trattano informazioni sanitarie protette (PHI) ai sensi di
HIPAA. Indirizzare qui le richieste quando il programma di conformità richiede
che l’elaborazione dei PDF avvenga in un ambiente allineato a HIPAA. Come ogni
regione, è *stateless* ed esegue il catalogo completo delle azioni.

## Scegliere una regione

Scegliere la regione corrispondente al luogo in cui i dati possono essere
elaborati:

- **Globale**: il valore predefinito. Latenza migliore, nessun vincolo di
  residenza.
- **Unione europea** (`eu.`): mantenere l’elaborazione nell’UE per il GDPR e gli
  altri requisiti europei di residenza dei dati.
- **Regno Unito** (`uk.`): mantenere l’elaborazione nel Regno Unito.
- **Stati Uniti** (`us.`) e **HIPAA Stati Uniti** (`hipaa.`): elaborare negli
  Stati Uniti, con l’endpoint HIPAA per i flussi di lavoro che trattano PHI.
- **Canada** (`ca.`), **Australia** (`au.`), **Giappone** (`jp.`),
  **India** (`in.`) e **Brasile** (`br.`): elaborare all’interno di quel paese
  per soddisfare le regole locali di residenza dei dati.

Se il requisito è semplicemente «tenere questo nella regione X», basta inviare
ogni richiesta all’host di quella regione.

## Cambiare regione

Cambiare regione è una modifica di una sola riga: mantenere identici il percorso,
i parametri e la chiave API e cambiare soltanto l’host. L’esempio qui sotto
esegue [Aggiungere una filigrana di
testo](/docs/api/add-text-watermark-to-pdf) nell’UE anziché in Globale.

```bash title="cURL"
# Global
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

# European Union: same request, EU host
curl https://eu.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 [chiave API](/docs/api/authentication) funziona su tutte le regioni. Non ci
sono chiavi per regione da gestire. Vedere
[Richieste e risposte](/docs/api/requests-and-responses) per la forma condivisa
da ogni chiamata.