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