# Introdução à API do PDF Blocks

O que é o PDF Blocks, o modelo que toda ação segue e o catálogo de tudo o que a API faz.

O PDF Blocks é uma API HTTP segura, rápida e *stateless* para trabalhar com
documentos PDF. Envie um documento, indique uma ação e receba o PDF processado
de volta na resposta. Não há estado de conta para gerenciar, nada é armazenado
depois que uma requisição termina e não há SDK para instalar: cada ação é uma
única chamada HTTPS autenticada, que você pode fazer de qualquer linguagem.

## O modelo mental

Um PDF entra, um PDF sai. Toda ação é uma transformação pura: recebe um documento
(mais alguns parâmetros), devolve um novo documento e não guarda nada. Você envia
`multipart/form-data` com seu PDF em um campo `file`, e uma ação de saída única
responde `200 OK` com `application/pdf`, trazendo o documento pronto no corpo da
resposta.

Como cada saída é, ela própria, um PDF válido, ela é uma entrada válida para a
ação seguinte. É isso que torna as ações combináveis: mescle vários arquivos,
aplique uma marca-d’água ao resultado e depois criptografe, com cada etapa
alimentando a seguinte. Consulte
[Encadear ações](/docs/api/chaining-actions) para montar um pipeline sem nunca
tocar no disco.

## O catálogo de ações

Dezessete ações, agrupadas por capacidade. Cada uma leva à sua referência completa.

### Mesclar e dividir

<CardGroup cols={3}>
  <Card title="Mesclar documentos" href="/docs/api/merge-pdf-documents">
    Combine uma lista ordenada de PDFs em um só.
  </Card>
  <Card title="Dividir por número de páginas" href="/docs/api/split-pdf-by-page-count">
    Divida em blocos de tamanho fixo.
  </Card>
  <Card title="Dividir em uma página" href="/docs/api/split-pdf-at-page">
    Divida no ponto de corte que você escolher.
  </Card>
  <Card title="Dividir por tamanho" href="/docs/api/split-pdf-by-file-size">
    Limite o tamanho em bytes de cada parte.
  </Card>
  <Card title="Dividir em grupos de páginas" href="/docs/api/split-pdf-into-page-groups">
    Agrupe as páginas por um padrão que você define.
  </Card>
</CardGroup>

### Marcas-d’água

<CardGroup cols={3}>
  <Card title="Adicionar marca-d’água de texto" href="/docs/api/add-text-watermark-to-pdf">
    Carimbe até três linhas de texto.
  </Card>
  <Card title="Adicionar marca-d’água de imagem" href="/docs/api/add-image-watermark-to-pdf">
    Carimbe um logotipo ou uma imagem.
  </Card>
</CardGroup>

### Senhas e segurança

<CardGroup cols={3}>
  <Card title="Adicionar senha" href="/docs/api/add-password-to-pdf">
    Criptografe um documento.
  </Card>
  <Card title="Remover senha" href="/docs/api/remove-password-from-pdf">
    Descriptografe um documento com uma senha conhecida.
  </Card>
  <Card title="Adicionar restrições" href="/docs/api/add-restrictions-to-pdf">
    Defina os sinalizadores de permissão.
  </Card>
  <Card title="Remover restrições" href="/docs/api/remove-restrictions-from-pdf">
    Limpe os sinalizadores de permissão.
  </Card>
  <Card title="Remover assinaturas" href="/docs/api/remove-signatures-from-pdf">
    Remova as assinaturas digitais.
  </Card>
</CardGroup>

### Páginas

<CardGroup cols={3}>
  <Card title="Extrair páginas" href="/docs/api/extract-pages-from-pdf">
    Mantenha um subconjunto de páginas.
  </Card>
  <Card title="Remover páginas" href="/docs/api/remove-pages-from-pdf">
    Descarte um subconjunto de páginas.
  </Card>
  <Card title="Girar páginas" href="/docs/api/rotate-pages-in-pdf">
    Gire as páginas em 90°, 180° ou 270°.
  </Card>
  <Card title="Inverter páginas" href="/docs/api/reverse-pages-of-pdf">
    Inverta a ordem das páginas.
  </Card>
  <Card title="Reordenar páginas" href="/docs/api/reorder-pages-of-pdf">
    Reorganize as páginas em qualquer ordem.
  </Card>
</CardGroup>

Para o panorama completo (a convenção de nomes, como as ações se combinam e onde
cada uma está documentada), consulte a [Visão geral das
ações](/docs/api/actions-overview).

## O que a torna diferente

- **Rápida.** As ações são transformações de propósito único, sem filas e sem
  idas e vindas. Você envia uma requisição e grava o resultado em fluxo
  diretamente em um arquivo.
- **Segura e stateless.** As requisições trafegam somente por HTTPS e se
  autenticam com uma chave secreta. Os documentos são processados na própria
  região e nunca são armazenados: depois que a resposta é escrita, não sobra
  nada.
- **Residência regional de dados.** O mesmo catálogo roda em dez regiões, então
  seus documentos podem ser processados onde a sua conformidade exigir. Aponte
  uma requisição para a URL base da região e todo o resto é idêntico.

| Região               | URL base                          |
| -------------------- | --------------------------------- |
| Global               | `https://api.pdfblocks.com`       |
| Estados Unidos       | `https://us.api.pdfblocks.com`    |
| HIPAA Estados Unidos | `https://hipaa.api.pdfblocks.com` |
| União Europeia       | `https://eu.api.pdfblocks.com`    |
| Reino Unido          | `https://uk.api.pdfblocks.com`    |
| Canadá               | `https://ca.api.pdfblocks.com`    |
| Austrália            | `https://au.api.pdfblocks.com`    |
| Japão                | `https://jp.api.pdfblocks.com`    |
| Índia                | `https://in.api.pdfblocks.com`    |
| Brasil               | `https://br.api.pdfblocks.com`    |

Consulte [Regiões e residência de dados](/docs/api/regions-and-data-residency)
para todos os detalhes.

## Para onde ir agora

<CardGroup cols={2}>

<Card title="Início rápido" href="/docs/api/quickstart">
  Faça sua primeira chamada autenticada e tenha um PDF processado em cinco minutos.
</Card>

<Card title="Autenticação" href="/docs/api/authentication">
  Obtenha uma chave de API e envie-a corretamente em toda requisição.
</Card>

</CardGroup>