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