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

Adicionar carimbo de texto a PDF - Marca d'água de texto API

PDF4me Adicionar carimbo de texto a PDF Permite adicionar marcas d'água de texto personalizáveis a PDF Documentos para autorização e prevenção da pirataria. Isto. API processos de serviço PDF O programa adiciona carimbos de texto com controle sobre o texto, posição, estilo, rotação e aparência. API recebe PDF conteúdo através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Esta solução é ideal para personalização de documentos, proteção de direitos autorais, indicadores de status 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​

  • Posicionamento flexívelControle o alinhamento horizontal e vertical com precisão perfeita de pixels.
  • Estilização personalizadaEscolha entre diversas fontes, tamanhos, cores e efeitos de texto (negrito, itálico, sublinhado).
  • Formatação avançadaDefina as opções de opacidade, rotação, margens e plano de fundo.
  • 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 que aprimorem a segurança e a identidade visual 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. Todas as operações de adição de carimbo de texto são realizadas por meio de um único ponto de extremidade:

  • Método: PUBLICAR
  • Ponto final: /api/v2/Stamp

Recursos de carimbo de texto suportados​

O API Oferece suporte completo para diversas funcionalidades de carimbo de texto e marca d'água:

Opções de personalização de texto​

  • Seleção de fontesEscolha entre Arial, Times New Roman, Helvetica ou Courier New.
  • Controle de tamanhoTamanho da fonte ajustável de 8 a 72
  • Opções de coresSuporte completo ao espectro de cores com códigos de cores hexadecimais (por exemplo, #FF0000 para vermelho)
  • Efeitos de textoOpções de formatação: negrito, itálico e sublinhado
  • Texto personalizadoSuporte para qualquer conteúdo de texto, incluindo símbolos e caracteres especiais.

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 e pixels.
  • Suporte de rotaçãoRotação do texto: 0 (horizontal), 45 (diagonal), 90 (vertical), -45 (diagonal inversa)
  • Colocação flexívelSuporte para qualquer posição da página com medidas exatas.

Recursos avançados​

  • Controle de opacidadeTransparência ajustável (0-100) para marcas d'água sutis ou proeminentes.
  • Modo de fundoOpção para posicionar o texto atrás ou na frente do conteúdo.
  • Controle de impressãoConfigure os carimbos para aparecerem na visualização e impressão ou somente na impressão.
  • Segmentação de páginaAplicar a páginas específicas ou a documentos inteiros.
  • Ajuste de texto: Dimensionamento automático do texto para se ajustar aos limites da página (opcional)

REST API Parâmetros​

Lista completa de parâmetros para Adicionar Carimbo de Texto 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*CordaSaída PDF nome do arquivo com extensão .pdfoutput.pdf
conteúdo do documento*Base64PDF conteúdo do arquivo codificado em Base64JVBERi...
páginas*CordaOpções de página: "todos", "1", "1,3,5", "2-5", "1,3,7-10", "2-"all
texto*CordaTexto a ser estampado como marca d'águaCONFIDENTIAL - PDF4me Watermark
alinharX*CordaAlinhamento horizontal: esquerda, centro, ou certocenter
alinharY*CordaAlinhamento vertical: principal, meio, ou fundomiddle

Parâmetros opcionais​

ParâmetroTipoDescriçãoExemplo
margemXEmMMCordaMargem horizontal a partir da borda esquerda em milímetros50
margemYInMMCordaMargem vertical a partir da borda superior em milímetros50
margemXInPxCordaMargem horizontal a partir da borda esquerda em pixels150
margemYInPxCordaMargem vertical a partir da borda superior em pixels150
opacidadeCordaOpacidade (0-100): 0 = invisível, 100 = totalmente opaco30
nome da fonteCordaNome da fonte: Arial, Times New Roman, Helvetica, Correio NovoArial
tamanho da fonteNúmero inteiroTamanho da fonte (8-72)24
cor da fonteCordaCor da fonte em formato hexadecimal (ex.: #FF0000 para vermelho)#FF0000
bola de geloBooleanoTornar o texto em negrito (verdadeiro) ou normal (falso)true
é em itálicoBooleanoExibir o texto em itálico (verdadeiro) ou normal (falso)false
sublinhadoBooleanoSublinhe o texto (verdadeiro) ou não (falso).false
girarNúmero inteiroÂngulo de rotação: 0 (horizontal), 45 (diagonal), 90 (vertical), -45 (diagonal inversa)45
é o fundoBooleanoColocar o selo em segundo plano (verdadeiro) ou em primeiro plano (falso)true
mostrarSomenteNaVersãoImpressaBooleanoExibir o carimbo e imprimir (falso) ou apenas imprimir (verdadeiro)false
transversalBooleanoPosicionamento transversal (verdadeiro) ou normal (falso)false
ajustarTextoSobrePáginaBooleanoAjustar o texto à página inteira (verdadeiro) ou usar o tamanho especificado (falso)false
assíncronoBooleanoAtive 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 Adicionar carimbo de texto a 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 carimbo de texto adicionado, 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==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle",
  "marginXInMM": "50",
  "marginYInMM": "50",
  "marginXInPx": "150",
  "marginYInPx": "150",
  "opacity": "30",
  "fontName": "Arial",
  "fontSize": 24,
  "fontColor": "#FF0000",
  "isBold": true,
  "isItalics": false,
  "underline": false,
  "rotate": 45,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false,
  "async": true
}

Exemplos de código​

O PDF4me Adicionar carimbo de texto a 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 adicionar carimbos de texto a PDF:

Recursos de carimbo de texto​

Opções de personalização​

  • Controle de fonteDiversas famílias de fontes com opções de personalização de tamanho e cor.
  • Efeitos de textoOpções de formatação: negrito, itálico e sublinhado
  • Gestão de coresSuporte completo ao espectro de cores com códigos hexadecimais.
  • Conteúdo do textoSuporte para qualquer texto, incluindo símbolos e caracteres especiais.
  • Estilização profissionalRenderização de texto 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
  • Suporte de rotaçãoRotação de texto para marcas d'água diagonais ou angulares
  • 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.

Recursos avançados​

  • Controle de opacidadeTransparência ajustável para marcas d'água sutis ou proeminentes.
  • Modo de fundoOpção para posicionar o texto atrás ou na frente do conteúdo.
  • Controle de impressãoConfigure os carimbos para aparecerem apenas na impressão ou na tela.
  • Ajuste de textoDimensionamento automático do texto para se ajustar aos limites da página
  • Modo transversalAplique os carimbos em toda a página.

Casos de uso e aplicações industriais​

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 selos de status a contratos e acordos
  • Avisos de ConfidencialidadeAplicar selos de confidencialidade a documentos jurídicos sensíveis.
  • Selos de ConformidadeAdicionar avisos de conformidade regulamentar a documentos legais

Obtenha ajuda​

Get Your API KeyAPI SamplesGetting Started