# Introducción a la API de PDF Blocks Qué es PDF Blocks, el modelo que sigue cada acción y el catálogo de todo lo que puede hacer la API. PDF Blocks es una API HTTP segura, rápida y *stateless* para trabajar con documentos PDF. Envíe un documento, indique una acción y reciba el PDF procesado directamente en la respuesta. No hay estado de cuenta que gestionar, no se almacena nada cuando la solicitud termina y no hay ningún SDK que instalar: cada acción es una única llamada HTTPS autenticada que puede hacer desde cualquier lenguaje. ## El modelo mental Entra un PDF, sale un PDF. Cada acción es una transformación pura: recibe un documento (más unos pocos parámetros), devuelve un documento nuevo y no conserva nada. Usted envía `multipart/form-data` con su PDF en un campo `file`, y una acción de salida única responde `200 OK` con `application/pdf`, es decir el documento terminado como cuerpo de la respuesta. Como cada salida es a su vez un PDF válido, sirve de entrada válida para la acción siguiente. Eso hace que las acciones se puedan combinar: una varios archivos, estampe el resultado y después cífrelo, con cada paso alimentando al siguiente. Consulte [Encadenar acciones](/docs/api/chaining-actions) para ver cómo construir un pipeline sin tocar el disco. ## El catálogo de acciones Diecisiete acciones, agrupadas por capacidad. Cada una enlaza a su referencia completa. ### Unir y dividir <CardGroup cols={3}> <Card title="Unir documentos" href="/docs/api/merge-pdf-documents"> Combine una lista ordenada de PDF en uno solo. </Card> <Card title="Dividir por número de páginas" href="/docs/api/split-pdf-by-page-count"> Divida en fragmentos de tamaño fijo. </Card> <Card title="Dividir en una página" href="/docs/api/split-pdf-at-page"> Divida en el límite de página que elija. </Card> <Card title="Dividir por tamaño" href="/docs/api/split-pdf-by-file-size"> Limite el tamaño en bytes de cada parte. </Card> <Card title="Dividir en grupos de páginas" href="/docs/api/split-pdf-into-page-groups"> Agrupe las páginas según un patrón que defina. </Card> </CardGroup> ### Marcas de agua <CardGroup cols={3}> <Card title="Añadir marca de agua de texto" href="/docs/api/add-text-watermark-to-pdf"> Estampe hasta tres líneas de texto. </Card> <Card title="Añadir marca de agua de imagen" href="/docs/api/add-image-watermark-to-pdf"> Estampe un logotipo o una imagen. </Card> </CardGroup> ### Contraseñas y seguridad <CardGroup cols={3}> <Card title="Añadir contraseña" href="/docs/api/add-password-to-pdf"> Cifre un documento. </Card> <Card title="Quitar contraseña" href="/docs/api/remove-password-from-pdf"> Descifre un documento cuya contraseña conoce. </Card> <Card title="Añadir restricciones" href="/docs/api/add-restrictions-to-pdf"> Establezca los indicadores de permisos. </Card> <Card title="Quitar restricciones" href="/docs/api/remove-restrictions-from-pdf"> Borre los indicadores de permisos. </Card> <Card title="Quitar firmas" href="/docs/api/remove-signatures-from-pdf"> Quite las firmas digitales. </Card> </CardGroup> ### Páginas <CardGroup cols={3}> <Card title="Extraer páginas" href="/docs/api/extract-pages-from-pdf"> Conserve un subconjunto de páginas. </Card> <Card title="Quitar páginas" href="/docs/api/remove-pages-from-pdf"> Descarte un subconjunto de páginas. </Card> <Card title="Girar páginas" href="/docs/api/rotate-pages-in-pdf"> Gire las páginas 90°, 180° o 270°. </Card> <Card title="Invertir páginas" href="/docs/api/reverse-pages-of-pdf"> Invierta el orden de las páginas. </Card> <Card title="Reordenar páginas" href="/docs/api/reorder-pages-of-pdf"> Reorganice las páginas en cualquier orden. </Card> </CardGroup> Para tener la imagen completa, con la convención de nombres, cómo se combinan las acciones y dónde vive cada una, consulte el [Resumen de las acciones](/docs/api/actions-overview). ## Qué la distingue - **Rápida.** Las acciones son transformaciones de un solo propósito, sin colas ni idas y venidas. Usted envía una solicitud y escribe el resultado directamente en un archivo. - **Segura y *stateless*.** Las solicitudes viajan solo por HTTPS y se autentican con una clave secreta. Los documentos se procesan dentro de la región y nunca se almacenan: en cuanto se escribe la respuesta, no queda nada. - **Residencia regional de los datos.** El mismo catálogo se ejecuta en diez regiones, así que sus documentos pueden procesarse donde su cumplimiento lo exija. Dirija la solicitud a la URL base de la región y todo lo demás es idéntico. | 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` | Consulte [Regiones y residencia de datos](/docs/api/regions-and-data-residency) para conocer todos los detalles. ## Por dónde seguir <CardGroup cols={2}> <Card title="Inicio rápido" href="/docs/api/quickstart"> Haga su primera llamada autenticada y tenga un PDF procesado en cinco minutos. </Card> <Card title="Autenticación" href="/docs/api/authentication"> Obtenga una clave de API y envíela correctamente en cada solicitud. </Card> </CardGroup>