Documentação do PDF Blocks
Por onde começar em cada integração, o catálogo de ações, os conceitos comuns a todas elas e a documentação de segurança e jurídica.
Toda ação segue o mesmo modelo: envie um documento, diga o que fazer com ele e receba o documento pronto de volta. Não há SDK para instalar nem estado para gerenciar, e nada é mantido depois que a resposta é enviada.
Comece pela forma como você pretende chamá-la, ou pesquise em todas as páginas
pelo cabeçalho (⌘K, ou Ctrl K no Windows).
Escolha sua integração
Para escrever código, em qualquer linguagem.
Uma chamada HTTPS autenticada por ação: multipart/form-data na entrada, um
PDF de volta. Todas as ações estão disponíveis, e cada saída é uma entrada
válida para a próxima.
Para criar um fluxo no Power Automate.
Nosso conector certificado, com todas as dezessete ações como etapas do fluxo. Os documentos passam de uma etapa para outra como conteúdo de arquivo, então nenhum armazenamento intermediário é necessário.
Para conectar aplicativos entre si sem código.
As ações mais comuns como etapas de um Zap, usando arquivos dos aplicativos que você já conecta. Comece por aqui pelas regras dos campos de arquivo, nas quais a maioria dos Zaps tropeça.
Experimente uma requisição
Coloque um PDF chamado input.pdf no seu diretório de trabalho, substitua pela
sua chave e execute isto. O comando carimba uma marca-d’água no documento e
grava o resultado em watermarked.pdf.
curl https://api.pdfblocks.com/v1/add_text_watermark \
-H 'X-API-Key: your_api_key' \
-F file=@input.pdf \
-F line_1='CONFIDENTIAL' \
-o watermarked.pdfA resposta é 200 OK com application/pdf e o documento pronto no corpo. Toda
ação de saída única segue esse mesmo formato, então trocar o nome da ação é
quase todo o trabalho de adotar a próxima. O Início
rápido traz a mesma chamada em Python, Node.js, PHP, Ruby
e outras linguagens, além de como obter uma chave.
O que você pode fazer
Dezessete ações, agrupadas por capacidade. Cada grupo leva ao catálogo completo, onde cada ação tem sua própria página de referência.
Combine uma lista ordenada de documentos, ou divida um deles por número de páginas, em uma página, por tamanho de arquivo ou em grupos que você define.
Carimbe texto ou uma imagem sobre as páginas, com controle de posição, rotação, opacidade e de quais páginas são cobertas.
Adicione ou remova uma senha, aplique ou suspenda restrições de permissão e remova as assinaturas existentes.
Extraia, remova, gire, inverta e reordene páginas, tudo com a mesma sintaxe de intervalos.
Conceitos fundamentais
Eles valem para todas as ações, e é onde a maior parte das dúvidas de integração é de fato respondida.
- Autenticação: como funcionam as chaves de API, o que enviar em cada requisição e como manter uma chave segura.
- Trabalhar com arquivos: como enviar documentos, os limites de tamanho e o que volta.
- Selecionar páginas: a sintaxe de intervalos
pagescompartilhada por todas as ações que operam sobre páginas. - Encadear ações: passar a saída de uma ação para a seguinte sem nunca tocar no disco.
- Formatos de resposta: a negociação de conteúdo e como respondem as ações que produzem vários documentos.
- Erros: o corpo do erro e o que significa cada código de status.
- Rate limits e uso: o que conta como requisição e o que acontece ao atingir um limite.
- Regiões e residência de dados: os endpoints regionais e onde cada um processa.
- Versionamento e estabilidade: o que pode mudar sob uma integração em funcionamento e o que não pode.
Segurança e conformidade
Dois fatos estruturais determinam a maior parte das perguntas de uma avaliação: os documentos nunca são armazenados e nenhum LLM os lê. Cada arquivo é processado em memória e devolvido na mesma resposta.
A seção Confiança tem o detalhamento: a Visão geral de segurança com um mapeamento de controles para o SOC 2, HIPAA e os termos do BAA, a lista de subprocessadores e o conjunto jurídico (Termos e condições, Política de privacidade e Adendo de processamento de dados).
Referência e suporte
Todas as mudanças da API, da mais recente para a mais antiga.
A especificação legível por máquina, para gerar um cliente ou importar nas suas ferramentas.
O que existe para cada linguagem, e por que não há SDK para instalar.
Como falar conosco, o que incluir e onde consultar o status atual.