Sinal PDF
Editar → Sinal PDF
O Sinal PDF API coloca uma imagem de assinatura no seu PDFVocê envia o PDF (docContent, docName), a imagem de assinatura (imageFile Base64, imageName), alignX e alignY, opcional pages, tamanho (mm ou px), margens, opacity, showOnlyInPrint, isBackground, e async. O API retorna o PDF Com a assinatura aplicada. Use o testador abaixo para experimentar; mais detalhes estão nas seções seguintes.
Experimente o sinal PDF API
:::nota Referência rápida
Ponto final: POST /api/v2/SignPdf · Obrigatório: api-key, docContent, docName, imageFile, imageName, alignX, alignY
:::
Use o formulário abaixo para enviar sua API chave, PDF (Base64), e imagem de assinatura (Base64A resposta é a PDF Com a assinatura. Nenhum código é necessário, preencha os campos e clique. Enviar solicitação.
Visão geral, parâmetros e casos de uso
- Overview
- Parameters
- Use cases
O que é um sinal? PDF?
Este endpoint insere uma imagem de assinatura em páginas específicas de um site. PDFVocê fornece o PDF (Base64), a imagem de assinatura (Base64), posição (alignX, alignY), opcional pages, tamanho (widthInMM/heightInMM ou widthInPx/heightInPx), margens em mm ou px, opacity (0-100), showOnlyInPrint, e isBackground. O API retorna o PDF Com a assinatura aplicada. Perfeito para adicionar assinaturas visuais a contratos, formulários ou cartas.
Principais características
- Imagem de assinatura: imageFile (Base64), imageName (ex.: assinatura.jpg).
- Posição e tamanho: alignX (Esquerda, Centro, Direita), alignY (Superior, Central, Inferior); tamanho em mm (10-200) ou px (20-600); margens em mm ou px.
- Opacidade: 0 = invisível, 100 = totalmente opaco (normalmente 100 para assinaturas).
- Segmentação de página: pages: por ex. 1, 1,3,5, 2-5, 1,3,7-10, 2-.
- showOnlyInPrintExibir assinatura somente na impressão; isBackground Coloca-o atrás ou na frente do conteúdo.
Use para assinaturas visuais em contratos, formulários ou documentos de aprovação. Para marcas d'água ou carimbos de imagem, use Adicionar carimbo de imagem PDF; para marcas d'água de texto use Adicionar carimbo de texto a PDF.
API parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| api-key | corda | Sim | Seu PDF4me API chave, Base64 codificado. Obtenha-o do painel. |
| docContent | base64 | Sim | PDF conteúdo do arquivo (Base64). |
| docName | corda | Sim | Saída PDF Nome do arquivo (ex.: output.pdf). |
| imageFile | base64 | Sim | Conteúdo da imagem de assinatura (Base64). |
| imageName | corda | Sim | Nome da imagem da assinatura com a extensão (ex.: assinatura.jpg). |
| alignX, alignY | corda | Sim | Esquerda/Centro/Direita; Superior/Meio/Inferior. |
| pages | corda | Não | por exemplo 1, 1,3,5, 2-5, 1,3,7-10, 2-. |
| widthInMM, heightInMM | corda | Não | Tamanho em mm (10-200). |
| widthInPx, heightInPx | corda | Não | Tamanho em pixels (20-600). |
| marginXInMM, marginYInMM, marginXInPx, marginYInPx | corda | Não | Margens em mm ou px. |
| opacity | corda | Não | 0-100. |
| showOnlyInPrint | booleano | Não | Exibir somente na impressão. |
| isBackground | booleano | Não | Assinar em segundo plano. |
| async | booleano | Não | Ativar o processamento assíncrono. |
Quando usar o Sign PDF
- Contratos e acordosAdicione uma imagem de assinatura visual aos documentos assinados.
- Formulários e aprovaçõesAssine os formulários de aprovação ou consentimento.
- Cartas e relatóriosAdicione a assinatura do autor ou signatário a cartas ou relatórios.
- Fluxos de trabalhoAutomatizar a inserção de uma imagem de assinatura armazenada em um arquivo gerado. PDFs.
Para esquemas de requisição/resposta e exemplos de código, consulte Sinal PDF no PDF4me API documentos.
Pré-requisitos
Antes de usar este endpoint, certifique-se de que você possui:
- Um válido PDF4me API chave (Adquira o seu API Chave)
- A PDF documento em Base64 formato ou um público URL para um PDF arquivo
- Um arquivo de imagem de assinatura (JPG, PNG, etc.)
Formato de resposta
O API retorna um PDF Documento com a imagem da assinatura aplicada às páginas especificadas.