Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Sinal PDF - Assinatura Digital API

PDF4me Sinal PDF permite adicionar imagens de assinatura a PDF documentos com controle sobre posição, tamanho e aparência. Isto API processos de serviço PDF arquivos e adiciona imagens de assinatura usando Base64 Codificação para transmissão segura. A API recebe PDF dados de imagem de conteúdo e assinatura por meio de REST API Essa solução é ideal para autenticação de documentos, conformidade legal, fluxos de trabalho empresariais e adição de assinaturas visuais a documentos.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue →

Autenticando seu API Solicitar​

Para acessar o PDF4me REST APIPara que uma solicitação seja aceita, é necessário incluir as credenciais de autenticação adequadas. A autenticação garante a segurança da comunicação e valida sua identidade como usuário autorizado do sistema. REST API.

Get your api Key

Principais características​

  • Suporte para assinatura de imagemAdicione imagens de assinatura personalizadas a PDF documentos com controle total sobre posicionamento e dimensionamento
  • Posicionamento flexívelControle o alinhamento horizontal e vertical com precisão perfeita de pixels.
  • Tamanhos personalizadosAjuste as dimensões da assinatura usando medidas em milímetros e pixels.
  • Formatação avançadaDefina as opções de opacidade, margens e plano de fundo para uma aparência profissional.
  • Segmentação de páginaAplicar assinaturas a páginas específicas ou a documentos inteiros.
  • Controle de impressãoConfigure as assinaturas para aparecerem apenas na versão impressa ou na tela.
  • Resultados profissionaisCrie assinaturas que aprimorem a autenticação e a segurança dos documentos.
  • Processamento assíncronoSuporte para processamento assíncrono com polling para operações de longa duração.

REST API Ponto final​

O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todos PDF As operações de assinatura são realizadas por meio de um único ponto de extremidade:

  • Método: POST
  • Ponto final: /api/v2/SignPdf

Apoiado PDF Recursos de assinatura​

O API Oferece suporte abrangente para diversas áreas. PDF Capacidades de assinatura:

Suporte para Imagem de Assinatura​

  • Formatos comunsSuporte para JPG, PNGe outros formatos de imagem padrão.
  • Base64 CodificaçãoTransmissão segura de assinaturas através de Base64 codificação
  • Tamanhos flexíveisOpções de dimensionamento baseadas em milímetros (10-200 mm) e pixels (20-600 px).
  • Preservação da QualidadeMantém a qualidade de imagem característica em PDF saída

Posicionamento e Layout​

  • Alinhamento horizontalOpções de posicionamento: Esquerda, Centro e Direita
  • Alinhamento verticalControle de posicionamento superior, central e inferior
  • Controle de MargemPosicionamento preciso com medições em milímetros (0-100 mm) e pixels (0-300 px).
  • Colocação flexívelSuporte para qualquer posição da página com medidas exatas.
  • Segmentação de páginaAplicar a páginas específicas ou a documentos inteiros (opcional)

Recursos avançados​

  • Controle de opacidadeTransparência ajustável (0-100) para assinaturas discretas ou em destaque.
  • Modo de fundoOpção para colocar assinaturas atrás ou antes do conteúdo.
  • Controle de impressãoConfigure as assinaturas para aparecerem na visualização e impressão ou somente na impressão.
  • Aparência profissionalRenderização de assinatura de alta qualidade com visibilidade nítida.

REST API Parâmetros​

Lista completa de parâmetros para o Sign PDF REST APIOs parâmetros estão organizados por categoria para melhor compreensão e implementação.

Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios e devem ser fornecidos para o API para funcionar corretamente.

Parâmetros obrigatórios​

ParâmetroTipoDescriçãoExemplo
nomeDoDocumento*StringSaída PDF nome do arquivo com extensão .pdfoutput.pdf
conteúdo do documento*Base64PDF conteúdo do arquivo codificado em Base64JVBERi...
arquivo de imagem*Base64Conteúdo do arquivo de imagem de assinatura codificado em Base64iVBORw0KGgoAAAANSUhEUgAA...
nome_da_imagem*StringNome do arquivo de imagem da assinatura com a extensão (ex.: .jpg, .png)signature.jpg
alinharX*StringAlinhamento horizontal: Esquerda, Centro, ou CertoRight
alinharY*StringAlinhamento vertical: Principal, Meio, ou FundoBottom

Parâmetros opcionais​

ParâmetroTipoDescriçãoExemplo
páginasStringOpções de página: "1", "1,3,5", "2-5", "1,3,7-10", "2-". Se não for especificado, aplica-se a todas as páginas.1-3
larguraEmMMStringLargura da assinatura em milímetros (10-200)50
alturaEmMMStringAltura da assinatura em milímetros (10-200)25
larguraEmPxStringLargura da assinatura em pixels (20-600)142
alturaEmPxStringAltura da assinatura em pixels (20-600)71
margemXEmMMStringMargem horizontal em milímetros (0-100)20
margemYInMMStringMargem vertical em milímetros (0-100)20
margemXInPxStringMargem horizontal em pixels (0-300)57
margemYInPxStringMargem vertical em pixels (0-300)57
opacidadeStringOpacidade (0-100): 0 = invisível, 100 = totalmente opaco100
mostrarSomenteNaVersãoImpressaBooleanExibir a assinatura e imprimi-la (verdadeiro) ou apenas imprimi-la (falso)true
é o fundoBooleanColocar assinatura em segundo plano (verdadeiro) ou em primeiro plano (falso)false
assíncronoBooleanAtive o processamento assíncrono. Quando true, o API retorna o status 202 e fornece uma opção de sondagem. URL no Location cabeçalhotrue

Saída​

O PDF4me Sinal PDF REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o PDF como um Base64string codificada em JSON formato, não como dados binários.

Processamento síncrono (padrão)

Quando async não está definido ou está definido como false, o API processa a solicitação imediatamente:

Código de status: 200 OK

Content-Type: application/json

Corpo da resposta:

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Campos de resposta:

  • nomeDoDocumento (string): A saída PDF nome do arquivo
  • conteúdo do documento (string): O PDF Arquivo com assinatura adicionada, codificado como Base64 corda

Como usar:

  1. Extraia o docContent campo do JSON resposta
  2. Decifre o Base64 string para obter o binário PDF dados
  3. Salvar ou processar o PDF arquive conforme necessário

Exemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

Exemplo de solicitação​

Cabeçalho​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Observação:

  • Adquira o seu API chave do PDF4me Painel
  • O API a chave deve ser Base64 codificado e prefixado com "Básico" no Authorization cabeçalho
  • Exemplo: Se o seu API chave é abc123, codifique-o para Base64 e usar Authorization: Basic YWJjMTIz

Carga útil​

Exemplo básico (somente campos obrigatórios):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "alignX": "Right",
  "alignY": "Bottom"
}

Exemplo avançado (com todos os campos opcionais):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "widthInMM": "50",
  "heightInMM": "25",
  "widthInPx": "142",
  "heightInPx": "71",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "57",
  "marginYInPx": "57",
  "opacity": "100",
  "showOnlyInPrint": true,
  "isBackground": false,
  "async": true
}

Exemplos de código​

O PDF4me Sinal PDF REST API Fornece exemplos de código em várias linguagens de programação. Escolha a linguagem que melhor se adapta ao seu ambiente de desenvolvimento:

C# (CSharp) Exemplo

Completo C# implementação para assinatura PDF documentos:

PDF Recursos de assinatura​

Controle de imagem de assinatura​

  • Suporte a formatos: JPG, PNG, GIF e outros formatos de imagem padrão
  • Preservação da QualidadeMantém a qualidade e a resolução de imagem características em PDF saída
  • Base64 CodificaçãoTransmissão segura de assinaturas através de Base64 codificação
  • Tamanhos flexíveisOpções de dimensionamento baseadas em milímetros e em pixels:
  • Aparência profissionalRenderização de assinatura de alta qualidade com visibilidade nítida.

Posicionamento e Layout​

  • Controle de alinhamentoOpções precisas de alinhamento horizontal e vertical.
  • Configurações de margemPosicionamento baseado em milímetros e em pixels
  • Colocação flexívelSuporte para qualquer posição e orientação da página.
  • Segmentação de páginaAplicar a páginas específicas ou a documentos inteiros.
  • Controle de tamanhoDimensões personalizáveis para um posicionamento ideal.

Recursos avançados​

  • Controle de opacidadeTransparência ajustável para assinaturas discretas ou em destaque.
  • Modo de fundoOpção para colocar assinaturas atrás ou antes do conteúdo.
  • Controle de impressãoConfigure as assinaturas para aparecerem apenas na versão impressa ou na tela.
  • Resultados profissionaisCrie assinaturas que aprimorem a autenticação e a segurança dos documentos.
  • Posicionamento flexívelControle o alinhamento horizontal e vertical com precisão perfeita de pixels.

Casos de uso e aplicações industriais​

Casos de uso de serviços jurídicos e profissionais

  • Documentação LegalAplicar assinaturas a contratos legais, acordos e documentos oficiais.
  • Assinatura de ContratoAssine contratos e acordos digitalmente para obter validade legal.
  • Documentos judiciaisAplicar assinaturas digitais a petições judiciais e documentos legais.
  • Requisitos de conformidadeAtender aos requisitos regulamentares para assinatura e autenticação de documentos.

Obtenha ajuda​

Get Your API KeyAPI SamplesGetting Started