# Visão geral das ações

O que é uma ação, o catálogo agrupado por capacidade e como a saída de uma ação vira a entrada da seguinte.

Uma **ação** é uma transformação de PDF única e pura, exposta como um único
endpoint. Você envia um documento, a ação faz exatamente uma coisa com ele
(mesclar, carimbar uma marca-d’água, criptografar, girar, dividir) e você recebe
o resultado de volta. As ações não guardam estado nem compartilham contexto; cada
chamada se basta. É essa uniformidade que permite encaixá-las em pipelines.

## O que é uma ação

Toda ação é um `POST` para `/v1/<action>`, onde `<action>` é o nome técnico das
tabelas abaixo. Todas seguem o mesmo
[contrato de requisição e resposta](/docs/api/requests-and-responses): um corpo
`multipart/form-data` com o PDF de entrada em um campo `file`, autenticado com o
cabeçalho `X-API-Key`. A maioria retorna um único `application/pdf`; a família de
divisão retorna vários documentos.

## O catálogo

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

### Mesclar e dividir

| Ação | Rota | O que faz |
| --- | --- | --- |
| [Mesclar documentos](/docs/api/merge-pdf-documents) | `/v1/merge_documents` | Combina uma matriz ordenada de PDFs em um único documento. |
| [Dividir por número de páginas](/docs/api/split-pdf-by-page-count) | `/v1/split_by_page_count` | Quebra um PDF em partes consecutivas com um número fixo de páginas. |
| [Dividir em uma página](/docs/api/split-pdf-at-page) | `/v1/split_at_page` | Divide um PDF em duas partes em um ponto de corte. |
| [Dividir por tamanho de arquivo](/docs/api/split-pdf-by-file-size) | `/v1/split_by_size` | Quebra um PDF em partes que não passam de um limite em bytes. |
| [Dividir em grupos de páginas](/docs/api/split-pdf-into-page-groups) | `/v1/split_by_groups` | Quebra um PDF em grupos de páginas definidos por você. |

Cada uma das quatro ações de divisão produz vários documentos; você escolhe o
empacotamento com o cabeçalho `Accept`. Consulte
[Formatos de resposta](/docs/api/response-formats).

### Marcas-d’água

| Ação | Rota | O que faz |
| --- | --- | --- |
| [Adicionar marca-d’água de texto](/docs/api/add-text-watermark-to-pdf) | `/v1/add_text_watermark` | Carimba até três linhas de texto estilizado nas páginas. |
| [Adicionar marca-d’água de imagem](/docs/api/add-image-watermark-to-pdf) | `/v1/add_image_watermark` | Carimba uma imagem PNG ou JPEG, como um logotipo, nas páginas. |

### Senhas e segurança

| Ação | Rota | O que faz |
| --- | --- | --- |
| [Adicionar senha](/docs/api/add-password-to-pdf) | `/v1/add_password` | Criptografa um documento com uma senha de abertura e/ou de permissões. |
| [Remover senha](/docs/api/remove-password-from-pdf) | `/v1/remove_password` | Descriptografa um documento quando você sabe a senha dele. |
| [Adicionar restrições](/docs/api/add-restrictions-to-pdf) | `/v1/add_restrictions` | Define os sinalizadores de permissão de impressão, cópia e edição. |
| [Remover restrições](/docs/api/remove-restrictions-from-pdf) | `/v1/remove_restrictions` | Limpa os sinalizadores de permissão de um documento. |
| [Remover assinaturas](/docs/api/remove-signatures-from-pdf) | `/v1/remove_signatures` | Remove as assinaturas digitais para que o documento possa ser editado. |

### Páginas

| Ação | Rota | O que faz |
| --- | --- | --- |
| [Extrair páginas](/docs/api/extract-pages-from-pdf) | `/v1/extract_pages` | Mantém um conjunto de páginas escolhido e descarta o resto. |
| [Remover páginas](/docs/api/remove-pages-from-pdf) | `/v1/remove_pages` | Descarta um conjunto de páginas escolhido e mantém o resto. |
| [Girar páginas](/docs/api/rotate-pages-in-pdf) | `/v1/rotate_pages` | Gira as páginas escolhidas em um múltiplo de 90 graus. |
| [Inverter páginas](/docs/api/reverse-pages-of-pdf) | `/v1/reverse_pages` | Inverte a ordem das páginas de ponta a ponta. |
| [Reordenar páginas](/docs/api/reorder-pages-of-pdf) | `/v1/reorder_pages` | Rearranja as páginas na ordem indicada por quem chama. |

## Como as ações se compõem

Como toda ação recebe um PDF e (nas ações de saída única) devolve um PDF, a saída
de uma ação é uma entrada válida para a seguinte. Nada é armazenado entre as
chamadas, então você compõe encaminhando bytes: mantenha a resposta de uma
requisição na memória e a poste como o `file` da próxima.

Um pipeline típico se lê da esquerda para a direita:

```text
merge_documents  →  add_text_watermark  →  add_password
   (many PDFs)         (one watermarked)      (one encrypted)
```

O guia [Encadear ações](/docs/api/chaining-actions) mostra isso de ponta a ponta,
em código, sem tocar no disco.

## Saída única ou várias saídas

A maioria das ações retorna um documento `application/pdf`. As quatro ações de
divisão retornam vários e deixam você escolher como eles são empacotados (um
arquivo ZIP, um envelope JSON ou um corpo `multipart/mixed`) por negociação de
conteúdo. Esse mecanismo tem uma casa só:
[Formatos de resposta](/docs/api/response-formats).