# Régions et résidence des données

Les URL de base régionales auxquelles envoyer vos requêtes, quels plans atteignent quelles régions, et ce que signifie un traitement qui reste dans une région.

Chaque action PDF Blocks s’exécute dans la région que vous adressez. Choisissez
une URL de base et votre document est traité là, et nulle part ailleurs. Choisir
une région revient simplement à remplacer l’hôte dans l’URL : chaque région
exécute le catalogue complet des 17 actions, avec la même disponibilité.

## Endpoints régionaux

Envoyez votre requête à l’URL de base de la région dans laquelle vous voulez que
le traitement ait lieu.

| Région           | URL de base                       |
| ---------------- | --------------------------------- |
| Global           | `https://api.pdfblocks.com`       |
| États-Unis       | `https://us.api.pdfblocks.com`    |
| HIPAA États-Unis | `https://hipaa.api.pdfblocks.com` |
| Union européenne | `https://eu.api.pdfblocks.com`    |
| Royaume-Uni      | `https://uk.api.pdfblocks.com`    |
| Canada           | `https://ca.api.pdfblocks.com`    |
| Australie        | `https://au.api.pdfblocks.com`    |
| Japon            | `https://jp.api.pdfblocks.com`    |
| Inde             | `https://in.api.pdfblocks.com`    |
| Brésil           | `https://br.api.pdfblocks.com`    |

Toutes les régions ci-dessus sont en service, servent le catalogue d’actions
complet et bénéficient du même engagement de disponibilité. L’endpoint **Global**
achemine chaque requête vers une infrastructure proche, pour la latence la plus
faible ; les endpoints régionaux nommés fixent le traitement à une juridiction
précise.

## Disponibilité des régions par plan

Les régions que vous pouvez adresser dépendent de votre plan :

- **Free** : Global.
- **Starter** : Global, États-Unis et Europe.
- **Business** : toutes les régions ci-dessus.

Voir la [tarification](/pricing) pour le détail complet.

## Ce que signifie « le traitement reste dans la région »

Une requête envoyée à une URL de base régionale est traitée entièrement dans
cette région. Votre envoi est reçu, transformé et renvoyé par une infrastructure
de cette juridiction : il ne voyage pas ailleurs pour être traité.

Comme l’API est **stateless**, il n’y a rien à stocker : votre document n’existe
en mémoire que le temps de la requête. Une fois la réponse renvoyée en flux,
l’entrée et la sortie ont disparu, et aucun bucket, aucune base de données ni
aucune file
d’attente ne conserve vos fichiers après l’appel. La résidence des données se
réduit donc à une seule décision : l’hôte auquel vous envoyez la requête.

## L’endpoint HIPAA États-Unis

`https://hipaa.api.pdfblocks.com` est un endpoint situé aux États-Unis, exploité
pour les traitements qui manipulent des informations de santé protégées (PHI) au
sens de HIPAA. Dirigez vos requêtes ici quand votre programme de conformité exige
que le traitement des PDF s’exécute dans un environnement aligné sur HIPAA. Comme
toutes les régions, il est *stateless* et exécute le catalogue d’actions complet.

## Choisir une région

Choisissez la région qui correspond à l’endroit où vos données ont le droit
d’être traitées :

- **Global** : le choix par défaut. Meilleure latence, aucune contrainte de
  résidence.
- **Union européenne** (`eu.`) : gardez le traitement dans l’UE pour le RGPD et
  les autres exigences européennes de résidence des données.
- **Royaume-Uni** (`uk.`) : gardez le traitement au Royaume-Uni.
- **États-Unis** (`us.`) et **HIPAA États-Unis** (`hipaa.`) : traitez aux
  États-Unis, avec l’endpoint HIPAA pour les traitements portant sur des PHI.
- **Canada** (`ca.`), **Australie** (`au.`), **Japon** (`jp.`), **Inde**
  (`in.`) et **Brésil** (`br.`) : traitez dans le pays concerné pour satisfaire
  les règles locales de résidence des données.

Si votre exigence est simplement « garder ceci dans la région X », envoyez toutes
vos requêtes à l’hôte de cette région et c’est terminé.

## Changer de région

Changer de région tient en une ligne : gardez le chemin, les paramètres et votre
clé d’API exactement identiques, et ne changez que l’hôte. L’exemple ci-dessous
exécute [Ajouter un filigrane texte](/docs/api/add-text-watermark-to-pdf)
dans l’UE plutôt qu’en 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
```

Votre [clé d’API](/docs/api/authentication) fonctionne sur toutes les régions :
il n’y a pas de clés par région à gérer. Voir
[Requêtes et réponses](/docs/api/requests-and-responses) pour la forme que
partage chaque appel.