# Regiões e residência de dados

As URLs base regionais para as quais você pode enviar requisições, quais planos alcançam quais regiões e o que significa o processamento ficar em uma delas.

Toda ação do PDF Blocks é executada na região que você endereça. Escolha uma URL
base e seu documento é processado ali e em nenhum outro lugar. Escolher uma
região é tão simples quanto trocar o host na URL. Toda região executa o catálogo
completo de 17 ações, com a mesma disponibilidade.

## Endpoints regionais

Envie sua requisição para a URL base da região em que você quer processar.

| Região               | URL base                          |
| -------------------- | --------------------------------- |
| Global               | `https://api.pdfblocks.com`       |
| Estados Unidos       | `https://us.api.pdfblocks.com`    |
| HIPAA Estados Unidos | `https://hipaa.api.pdfblocks.com` |
| União Europeia       | `https://eu.api.pdfblocks.com`    |
| Reino Unido          | `https://uk.api.pdfblocks.com`    |
| Canadá               | `https://ca.api.pdfblocks.com`    |
| Austrália            | `https://au.api.pdfblocks.com`    |
| Japão                | `https://jp.api.pdfblocks.com`    |
| Índia                | `https://in.api.pdfblocks.com`    |
| Brasil               | `https://br.api.pdfblocks.com`    |

Todas as regiões acima estão no ar, servem o catálogo completo de ações e contam
com o mesmo compromisso de disponibilidade. O endpoint **Global** roteia cada
requisição para uma infraestrutura próxima, em busca da menor latência; os
endpoints regionais nomeados fixam o processamento em uma jurisdição específica.

## Disponibilidade de regiões por plano

As regiões que você pode endereçar dependem do seu plano:

- **Free**: Global.
- **Starter**: Global, Estados Unidos e Europa.
- **Business**: todas as regiões acima.

Consulte os [preços](/pricing) para ver o detalhamento completo.

## O que significa “o processamento fica na região”

Uma requisição enviada para uma URL base regional é processada inteiramente
dentro daquela região. Seu upload é recebido, transformado e devolvido por uma
infraestrutura daquela jurisdição. Ele não viaja para outro lugar para ser
processado.

Como a API é **stateless**, não há nada a armazenar: seu documento existe apenas
na memória, pelo tempo de vida da requisição. Assim que a resposta é devolvida, a
entrada e a saída deixam de existir; não há bucket, banco de dados nem fila que
retenha seus arquivos depois que a chamada termina. A residência de dados se
resume, portanto, a uma única decisão: para qual host você envia a requisição.

## O endpoint HIPAA Estados Unidos

`https://hipaa.api.pdfblocks.com` é um endpoint nos Estados Unidos operado para
fluxos de trabalho que lidam com informações de saúde protegidas (PHI) sob a
HIPAA. Direcione as requisições para cá quando seu programa de conformidade
exigir que o processamento de PDF seja executado em um ambiente alinhado à HIPAA.
Como toda região, ele é *stateless* e executa o catálogo completo de ações.

## Escolher uma região

Escolha a região que corresponde ao lugar onde seus dados podem ser processados:

- **Global**: o padrão. Melhor latência, sem restrição de residência.
- **União Europeia** (`eu.`): mantenha o processamento na UE para o GDPR e as
  demais exigências europeias de residência de dados.
- **Reino Unido** (`uk.`): mantenha o processamento no Reino Unido.
- **Estados Unidos** (`us.`) e **HIPAA Estados Unidos** (`hipaa.`): processe nos
  Estados Unidos, com o endpoint HIPAA para os fluxos de trabalho com PHI.
- **Canadá** (`ca.`), **Austrália** (`au.`), **Japão** (`jp.`),
  **Índia** (`in.`) e **Brasil** (`br.`): processe dentro daquele país para
  atender às regras locais de residência de dados.

Se sua exigência é simplesmente “manter isto na região X”, envie todas as
requisições para o host daquela região e pronto.

## Trocar de região

Trocar de região é uma alteração de uma linha: mantenha o caminho, os parâmetros
e sua chave de API exatamente iguais e mude apenas o host. O exemplo abaixo
executa [Adicionar uma marca-d’água de texto](/docs/api/add-text-watermark-to-pdf)
na UE em vez da Global.

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

Sua [chave de API](/docs/api/authentication) funciona em todas as regiões. Não há
chaves por região para gerenciar. Consulte
[Requisições e respostas](/docs/api/requests-and-responses) para conhecer o
formato que toda chamada compartilha.