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