Adicionar carimbo de imagem PDF - Marca d'água API

PDF4me Adicionar carimbo de imagem PDF Permite adicionar carimbos de imagem e marcas d'água personalizáveis a PDF documentos. Isto API processos de serviço PDF O editor de arquivos adiciona marcas d'água de imagem com posicionamento preciso, dimensionamento personalizado e opções de formatação para identidade visual e segurança de documentos. API recebe PDF dados de conteúdo e imagem através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para posicionamento flexível, dimensionamento personalizado, direcionamento de página e controle de impressão, esta solução é ideal para identidade visual de documentos, proteção de direitos autorais e aplicações corporativas. PDF fluxos de trabalho.

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 marca d'água em imagensAdicione imagens personalizadas como marcas d'água e carimbos a PDF documentos
• Posicionamento flexívelControle o alinhamento horizontal e vertical com precisão perfeita de pixels.
• Tamanhos personalizadosAjuste as dimensões da imagem 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 carimbos a páginas específicas ou a documentos inteiros.
• Controle de impressãoConfigure os carimbos para aparecerem apenas na impressão ou na tela.
• Resultados profissionaisCrie marcas d'água em imagens que aprimorem a segurança e a identidade visual dos documentos.
• Sem costura API Integração: REST API projetado para automatizado PDF fluxos de trabalho de edição e integração de sistemas empresariais

REST API Ponto final

O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de adição de carimbos de imagem são realizadas por meio de um único ponto de extremidade:

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

Recursos de carimbo de imagem

Suporte a formatos de imagem

• Formatos comunsSuporte para JPG, PNG, GIF e outros formatos de imagem padrão
• Base64 CodificaçãoTransmissão segura de imagens através de Base64 codificação
• Controle de tamanhoOpções de dimensionamento em milímetros (10-200 mm) e em pixels (20-600 px).

Posicionamento e Layout

• Alinhamento horizontalOpções de posicionamento: Esquerda, Centro ou Direita
• Alinhamento verticalControle de posicionamento: Superior, Central ou Inferior
• Controle de MargemPosicionamento preciso com medições em milímetros (0-100 mm) e em pixels (0-300 px).
• Segmentação de páginaAplicar a páginas específicas usando opções de página (string vazia para todas as páginas, "1", "1,3,5", "2-5", "1,3,7-10", "2-")

Recursos avançados

• Controle de opacidadeTransparência ajustável (0-100): 0 = invisível, 100 = totalmente opaco
• Modo de fundo: Opção para colocar imagens atrás (isBackground: true) ou na frente (isBackground: false) de conteúdo
• Controle de impressãoConfigurar selos para aparecerem apenas na impressão (showOnlyInPrint: true) ou em visualização e impressão (showOnlyInPrint: false)
• Processamento assíncronoSuporte para processamento assíncrono com polling para operações de longa duração.

REST API Parâmetros

Lista completa de parâmetros para Adicionar Carimbo de Imagem 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âmetro	Tipo	Descrição	Exemplo
nomeDoDocumento*	String	Saída PDF nome do arquivo com extensão .pdf	output.pdf
conteúdo do documento*	Base64	O conteúdo da entrada PDF arquivo codificado em Base64	JVBERi...
nome_da_imagem*	String	Nome do arquivo de imagem com extensão (ex.: .png, .jpg)	stamp.png
arquivo de imagem*	Base64	Conteúdo do arquivo de imagem codificado em Base64 formato	iVBORw0KGgoAAAANS...
alinharX*	String	Alinhamento horizontal: Esquerda, Centro, ou Certo	Center
alinharY*	String	Alinhamento vertical: Principal, Meio, ou Fundo	Middle

Parâmetros opcionais

Parâmetro	Tipo	Descrição	Exemplo
páginas	String	Opções da página: texto vazio para todas as páginas. "1" para a página 1, "1,3,5" para páginas específicas, "2-5" para intervalo de páginas, "1,3,7-10" para misto, "2-" para as páginas de 2 até o final	"" ou "1-3"
alturaEmMM	String	Altura da imagem em milímetros (10-200)	30
larguraEmMM	String	Largura da imagem em milímetros (10-200)	30
alturaEmPx	String	Altura da imagem em pixels (20-600)	85
larguraEmPx	String	Largura da imagem em pixels (20-600)	85
margemXEmMM	String	Margem horizontal em milímetros (0-100)	10
margemYInMM	String	Margem vertical em milímetros (0-100)	10
margemXInPx	String	Margem horizontal em pixels (0-300)	28
margemYInPx	String	Margem vertical em pixels (0-300)	28
opacidade	Integer	Nível de opacidade (0-100): 0 = invisível, 100 = totalmente opaco	50
é o fundo	Boolean	Colocar o selo em segundo plano (verdadeiro) ou em primeiro plano (falso)	true
mostrarSomenteNaVersãoImpressa	Boolean	Mostrar apenas na versão impressa (verdadeiro) ou na versão visual e impressa (falso)	false
assíncrono	Boolean	Ative o processamento assíncrono. Quando true, o API retorna o status 202 e fornece uma opção de sondagem. URL no Location cabeçalho	true

Saída

O PDF4me Adicionar carimbo de imagem 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.

Success Response

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 carimbo de imagem aplicado, 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

Asynchronous Processing

Processamento assíncrono

Quando async: true está definido, o API processa a solicitação de forma assíncrona:

Código de status: 202 Accepted

Cabeçalhos de resposta:

Location: https://api.pdf4me.com/api/v2/ImageStamp/poll/12345-abcde-67890

Processo de votação:

1. Extraia o Location cabeçalho da resposta 202
2. Faça a pesquisa URL usando GET solicitações
3. Continue votando até receber um 200 OK status
4. A resposta final contém o mesmo JSON formato com docName e docContent (Base64)

Exemplo de votação:

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Error Responses

Respostas de erro

O API retorna padrão HTTP Códigos de erro com detalhes do erro:

400 Bad Request

• Parâmetros de solicitação inválidos
• Campos obrigatórios ausentes (nomeDoDocumento, conteúdo do documento, nome_da_imagem, arquivo de imagem, alinharX, alinharY)
• Inválido Base64 codificação em conteúdo do documento ou arquivo de imagem
• Valores de alinhamento inválidos (devem ser: Esquerda/Centro/Direita para alignX, Superior/Meio/Inferior para alignY)
• Valores de tamanho ou margem inválidos (fora dos intervalos permitidos)

401 Unauthorized

• Inválido ou ausente API chave
• API chave não está corretamente Base64 codificado em Authorization cabeçalho
• Ausente Autorização: Básica cabeçalho

500 Internal Server Error

• Erro de processamento no servidor
• PDF falha de processamento
• Falha na aplicação do carimbo de imagem

Formato da resposta de erro:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

Detalhes do formato da resposta

Importante: O API sempre retorna JSON, nunca binário PDF dados diretamente.

Estrutura da resposta:

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type Cabeçalho:

• Sucesso: application/json
• O PDF está incorporado como um Base64 string dentro do JSON resposta

Por que Base64?

• JSON-Codificação segura para dados binários
• Fácil de transmitir HTTP
• Compatível com todas as linguagens de programação.
• Pode ser incorporado diretamente em JSON sem escapar dos problemas

Decodificando Base64 para PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", 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==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle",
  "pages": "",
  "heightInMM": "30",
  "widthInMM": "30",
  "heightInPx": "85",
  "widthInPx": "85",
  "marginXInMM": "10",
  "marginYInMM": "10",
  "marginXInPx": "28",
  "marginYInPx": "28",
  "opacity": 50,
  "isBackground": true,
  "showOnlyInPrint": false,
  "async": true
}

Exemplos de código

O PDF4me Adicionar carimbo de imagem 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#

C# (CSharp) Amostra

Completo C# Implementação para adicionar carimbos de imagem a PDF:

View C# Sample

Java

Java Amostra

Java Implementação com tratamento completo de erros e processamento de respostas:

View Java Sample

JavaScript

JavaScript Amostra

Node.js e compatível com navegadores JavaScript Implementação:

View JavaScript Sample

Python

Python Amostra

Python implementação com a biblioteca requests e JSON manuseio:

View Python Sample

Salesforce

Salesforce Amostra

Salesforce Apex implementação para CRM integração:

View Salesforce Sample

n8n

n8n Amostra

n8n Implementação de fluxo de trabalho para automação:

View n8n Sample

Google Script

Google Script Amostra

Google Apps Script implementação para Google Workspace integração:

View Google Script Sample

AWS Lambda

AWS Lambda Amostra

Sem servidor AWS Lambda Implementação da função:

View AWS Lambda Sample

Casos de uso e aplicações industriais

Legal & Professional Services

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

• Documentação LegalAplicar avisos legais de isenção de responsabilidade e confidencialidade a documentos jurídicos.
• Carimbo de contratoAdicionar carimbos de imagem a contratos e acordos
• Avisos de ConfidencialidadeAplicar selos de confidencialidade em documentos jurídicos sensíveis.
• Selos de ConformidadeAdicionar avisos visuais de conformidade regulamentar a documentos legais

Business & Enterprise

Casos de uso para empresas e negócios

• Identidade Visual de DocumentosAdicione logotipos, marcas d'água e elementos de identidade visual da empresa a documentos PDF.
• Indicadores de statusAdicione carimbos de imagem "RASCUNHO", "CONFIDENCIAL" ou "APROVADO" para indicar o status do documento.
• Geração de relatóriosAdicionar carimbos de data/hora, números de página e identificadores de relatório aos documentos gerados.
• Identidade Visual CorporativaAplicar uma identidade visual consistente em todos os documentos da empresa.

Finance & Banking

Casos de uso em finanças e bancos

• Relatórios financeirosAdicionar carimbos de imagem a relatórios e demonstrações financeiras.
• Carimbo de faturaAplicar selos de aprovação com imagens às faturas e ordens de compra.
• Documentação de ConformidadeAdicionar selos de imagem regulamentares a documentos financeiros.
• Trilhas de auditoriaCrie trilhas de auditoria com carimbos de data e hora em imagens de documentos financeiros.

Government & Compliance

Casos de uso para governo e conformidade

• Proteção de direitos autoraisAplicar avisos de direitos autorais e marcas de propriedade intelectual para proteger a propriedade intelectual.
• Conformidade regulatóriaAdicionar selos de conformidade para atender aos requisitos regulamentares
• Documentação oficialAplicar carimbos de imagem oficiais a documentos governamentais.
• Registros PúblicosAdicionar carimbos de classificação de imagens a registros e documentos públicos.

Obtenha ajuda

Get Your API KeyAPI SamplesGetting Started