Regiones y residencia de datos
Las URL base regionales a las que puede enviar solicitudes, qué planes llegan a qué regiones y qué significa que el procesamiento se quede en una.
Cada acción de PDF Blocks se ejecuta en la región a la que usted se dirige. Elija una URL base y su documento se procesará allí y en ningún otro sitio. Elegir región es tan sencillo como cambiar el host de la URL: todas las regiones ejecutan el catálogo completo de 17 acciones, con la misma disponibilidad.
Endpoints regionales
Envíe su solicitud a la URL base de la región en la que quiera procesar.
| Región | URL base |
|---|---|
| Global | https://api.pdfblocks.com |
| Estados Unidos | https://us.api.pdfblocks.com |
| HIPAA de EE. UU. | https://hipaa.api.pdfblocks.com |
| Unión Europea | https://eu.api.pdfblocks.com |
| Reino Unido | https://uk.api.pdfblocks.com |
| Canadá | https://ca.api.pdfblocks.com |
| Australia | https://au.api.pdfblocks.com |
| Japón | https://jp.api.pdfblocks.com |
| India | https://in.api.pdfblocks.com |
| Brasil | https://br.api.pdfblocks.com |
Todas las regiones anteriores están activas, sirven el catálogo completo de acciones y están respaldadas por el mismo compromiso de disponibilidad. El endpoint Global dirige cada solicitud a la infraestructura más cercana para lograr la latencia más baja; los endpoints regionales con nombre fijan el procesamiento a una jurisdicción concreta.
Disponibilidad de regiones por plan
Las regiones a las que puede dirigirse dependen de su plan:
- Free: Global.
- Starter: Global, EE. UU. y Europa.
- Business: todas las regiones anteriores.
Consulte los precios para ver el desglose completo.
Qué significa que “el procesamiento se queda en la región”
Una solicitud enviada a una URL base regional se procesa por completo dentro de esa región. Su envío se recibe, se transforma y se devuelve por infraestructura de esa jurisdicción: no viaja a otro lugar para procesarse.
Como la API es stateless, no hay nada que almacenar: su documento existe solo en memoria durante la vida de la solicitud. En cuanto se devuelve la respuesta, la entrada y la salida desaparecen: no hay bucket, base de datos ni cola que conserve sus archivos después de la llamada. Por tanto, la residencia de los datos se reduce a una sola decisión: a qué host envía la solicitud.
El endpoint HIPAA de EE. UU.
https://hipaa.api.pdfblocks.com es un endpoint de Estados Unidos operado
para flujos de trabajo que manejan información médica protegida (PHI)
conforme a HIPAA. Dirija aquí sus solicitudes cuando su programa de
cumplimiento exija que el procesamiento de PDF se ejecute en un entorno
alineado con HIPAA. Como todas las regiones, es stateless y ejecuta el
catálogo completo de acciones.
Cómo elegir una región
Elija la región que corresponda al lugar donde se permite procesar sus datos:
- Global: la opción predeterminada. La mejor latencia y sin restricción de residencia.
- Unión Europea (
eu.): mantenga el procesamiento dentro de la UE para el RGPD y otros requisitos europeos de residencia de datos. - Reino Unido (
uk.): mantenga el procesamiento dentro del Reino Unido. - Estados Unidos (
us.) y HIPAA de EE. UU. (hipaa.): procese en Estados Unidos, con el endpoint HIPAA para flujos con PHI. - Canadá (
ca.), Australia (au.), Japón (jp.), India (in.) y Brasil (br.): procese dentro de ese país para cumplir las normas locales de residencia de datos.
Si su requisito es simplemente “que esto se quede en la región X”, envíe todas las solicitudes al host de esa región y ya está.
Cómo cambiar de región
Cambiar de región es un cambio de una línea: mantenga la ruta, los parámetros y su clave de API exactamente iguales y cambie solo el host. El ejemplo siguiente ejecuta Añadir una marca de agua de texto en la UE en lugar de en Global.
# 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.pdfSu clave de API funciona en todas las regiones: no hay claves por región que gestionar. Consulte Solicitudes y respuestas para conocer la forma que comparten todas las llamadas.