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