# Registro de alterações

O que mudou em cada versão da API do PDF Blocks, da mais recente para a mais antiga.

O que mudou na API do PDF Blocks, atrelado à sua versão
[SemVer](https://semver.org). A versão atual é `1.18`.

<Note>
  Este registro é uma **estrutura voltada para o futuro**. Ele mostra a versão
  atual e o formato das entradas; cada versão futura receberá aqui uma entrada
  datada. Somente mudanças verificadas são listadas: nada de histórico
  inventado.
</Note>

## Como ler

As entradas são agrupadas por versão, da mais recente para a mais antiga, e
marcadas como **Adicionado**, **Alterado** ou **Corrigido**. A versão segue o
SemVer 2.0.0, e a versão maior (`v1`) aparece em toda rota. Consulte
[Versionamento e estabilidade](/docs/api/versioning-and-stability) para saber o
que conta como mudança retrocompatível e como as mudanças incompatíveis seriam
publicadas.

## 1.18: atual

A API expõe a superfície completa de **17 ações**: mesclar documentos; adicionar
marcas-d’água de texto e de imagem; adicionar e remover senhas; adicionar e
remover restrições; remover assinaturas; extrair, remover, girar, inverter e
reordenar páginas; e dividir por número de páginas, em uma página, por tamanho e
em grupos de páginas.

As adições mais recentes que chegaram nesta versão:

- **Adicionado**: a **família de divisões**: `split_by_page_count`,
  `split_at_page`, `split_by_size` e `split_by_groups`. Elas retornam vários
  documentos; o formato (ZIP, JSON ou multipart) é escolhido com o cabeçalho
  `Accept`. Consulte [Formatos de resposta](/docs/api/response-formats).
- **Adicionado**: `reorder_pages`, que emite as páginas em uma sequência
  [`page_order`](/docs/api/selecting-pages) explícita.
- **Adicionado**: o seletor `pages` nas ações de página e de marca-d’água, para
  direcionar um subconjunto de páginas com uma sintaxe de intervalos compacta
  como `1..3,5`.