# Regionen und Datenresidenz Die regionalen Basis-URLs, an die Sie Anfragen senden können, welche Pläne welche Regionen erreichen und was es bedeutet, dass die Verarbeitung in einer Region bleibt. Jede Aktion von PDF Blocks läuft in der Region, die Sie ansprechen. Wählen Sie eine Basis-URL, und Ihr Dokument wird dort verarbeitet und nirgendwo sonst. Eine Region zu wählen bedeutet lediglich, den Host in der URL auszutauschen. Jede Region führt den vollständigen Katalog von 17 Aktionen aus, mit derselben Verfügbarkeit. ## Regionale Endpoints Senden Sie Ihre Anfrage an die Basis-URL der Region, in der Sie verarbeiten möchten. | Region | Basis-URL | | ---------------------- | --------------------------------- | | Global | `https://api.pdfblocks.com` | | USA | `https://us.api.pdfblocks.com` | | HIPAA USA | `https://hipaa.api.pdfblocks.com` | | Europäische Union | `https://eu.api.pdfblocks.com` | | Vereinigtes Königreich | `https://uk.api.pdfblocks.com` | | Kanada | `https://ca.api.pdfblocks.com` | | Australien | `https://au.api.pdfblocks.com` | | Japan | `https://jp.api.pdfblocks.com` | | Indien | `https://in.api.pdfblocks.com` | | Brasilien | `https://br.api.pdfblocks.com` | Jede Region oben ist in Betrieb, bedient den vollständigen Katalog der Aktionen und wird von derselben Verfügbarkeitszusage getragen. Der Endpoint **Global** leitet jede Anfrage an nahe gelegene Infrastruktur weiter, für die geringste Latenz; die benannten regionalen Endpoints binden die Verarbeitung an eine bestimmte Rechtsordnung. ## Verfügbarkeit der Regionen nach Plan Welche Regionen Sie ansprechen können, hängt von Ihrem Plan ab: - **Free**: Global. - **Starter**: Global, USA und Europa. - **Business**: jede Region oben. Siehe [Preise](/pricing) für die vollständige Aufschlüsselung. ## Was „die Verarbeitung bleibt in der Region“ bedeutet Eine Anfrage an eine regionale Basis-URL wird vollständig innerhalb dieser Region verarbeitet. Ihr Upload wird von Infrastruktur in dieser Rechtsordnung entgegengenommen, umgewandelt und zurückgegeben. Er wandert nicht anderswohin, um verarbeitet zu werden. Da die API *stateless* ist, gibt es nichts zu speichern: Ihr Dokument existiert nur für die Dauer der Anfrage im Arbeitsspeicher. Sobald die Antwort als Stream zurückgegeben ist, sind Eingabe und Ausgabe verschwunden; es gibt keinen Bucket, keine Datenbank und keine Warteschlange, die Ihre Dateien nach dem Abschluss des Aufrufs behält. Datenresidenz läuft damit auf eine einzige Entscheidung hinaus: an welchen Host Sie die Anfrage senden. ## Der Endpoint HIPAA USA `https://hipaa.api.pdfblocks.com` ist ein Endpoint in den USA, der für Abläufe betrieben wird, die geschützte Gesundheitsdaten (PHI) im Sinne von HIPAA verarbeiten. Leiten Sie Anfragen hierher, wenn Ihr Compliance-Programm verlangt, dass die Verarbeitung von PDF-Dokumenten in einer an HIPAA ausgerichteten Umgebung läuft. Wie jede Region ist er *stateless* und führt den vollständigen Katalog der Aktionen aus. ## Eine Region wählen Wählen Sie die Region, die dazu passt, wo Ihre Daten verarbeitet werden dürfen: - **Global**: die Voreinstellung. Beste Latenz, keine Vorgabe zur Residenz. - **Europäische Union** (`eu.`): Halten Sie die Verarbeitung innerhalb der EU, für die DSGVO und andere EU-Anforderungen an die Datenresidenz. - **Vereinigtes Königreich** (`uk.`): Halten Sie die Verarbeitung innerhalb des Vereinigten Königreichs. - **USA** (`us.`) und **HIPAA USA** (`hipaa.`): Verarbeiten Sie in den USA, mit dem Endpoint HIPAA für Abläufe mit PHI. - **Kanada** (`ca.`), **Australien** (`au.`), **Japan** (`jp.`), **Indien** (`in.`) und **Brasilien** (`br.`): Verarbeiten Sie im jeweiligen Land, um lokale Vorgaben zur Datenresidenz zu erfüllen. Wenn Ihre Anforderung schlicht lautet „das bleibt in Region X“, senden Sie jede Anfrage an den Host dieser Region, und Sie sind fertig. ## Regionen wechseln Ein Regionswechsel ist eine Änderung in einer einzigen Zeile: Behalten Sie den Pfad, die Parameter und Ihren API-Schlüssel genau bei und ändern Sie nur den Host. Das Beispiel unten führt [Textwasserzeichen hinzufügen](/docs/api/add-text-watermark-to-pdf) in der EU statt in Global aus. ```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 ``` Ihr [API-Schlüssel](/docs/api/authentication) funktioniert in jeder Region. Es gibt keine Schlüssel pro Region zu verwalten. Siehe [Anfragen und Antworten](/docs/api/requests-and-responses) für die Form, die jeder Aufruf teilt.