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