Adicionar carimbo de imagem PDF
Editar → Adicionar carimbo de imagem PDF
O Adicionar carimbo de imagem PDF API coloca uma imagem (por exemplo, um logotipo ou marca d'água) em seu PDFVocê envia o PDF (docContent, docName), a imagem (imageFile Base64, imageName), alignX e alignY, opcional pages, tamanho (mm ou px), margens, opacity, isBackground, e showOnlyInPrint. O API retorna o PDF Com o carimbo de imagem aplicado. Use o testador abaixo para experimentar; mais detalhes estão nas seções seguintes.
Experimente adicionar um carimbo de imagem. PDF API
:::nota Referência rápida
Ponto final: POST /api/v2/ImageStamp · Obrigatório: api-key, docContent, docName, imageFile, imageName, alignX, alignY
:::
Use o formulário abaixo para enviar sua API chave, PDF (Base64), imagem de selo (Base64), e posição. A resposta é a PDF com a imagem de carimbo. 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 é "Adicionar carimbo de imagem"? PDF?
Este endpoint insere uma imagem (logotipo, marca d'água ou carimbo) em páginas específicas de um site. PDFVocê escolhe a posição através de alignX (Esquerda, Centro, Direita) e alignY (Superior, Central, Inferior), tamanho opcional (altura/largura em mm ou px), margens, opacity (0-100), e se o selo está no fundo ou visível apenas na impressão.
Principais características
- Posição e tamanho: alignX/alignY; opcional heightInMM/widthInMM ou heightInPx/widthInPx; margens em mm ou px.
- Opacidade: 0 = invisível, 100 = totalmente opaco (ex.: 50 para uma marca d'água clara).
- Plano de fundo/primeiro plano: isBackground Coloca o carimbo atrás ou na frente do conteúdo.
- Somente para impressão: showOnlyInPrint O carimbo só aparece na impressão.
- Segmentação de página: pages: vazio para todos, ou por exemplo.
1,1,3,5,2-5.
Use para marcas, marcas d'água de direitos autorais ou selos "RASCUNHO"/"CONFIDENCIAL". Para marcas d'água somente de texto, use Adicionar carimbo de texto a PDF; para uso de assinatura Sinal 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 do arquivo de imagem (Base64). |
| imageName | corda | Sim | Nome do arquivo de imagem com extensão (ex.: stamp.png). |
| alignX, alignY | corda | Sim | Esquerda/Centro/Direita; Superior/Meio/Inferior. |
| pages | corda | Não | Vazio para todos, ou por exemplo. 1, 1,3,5, 2-5. |
| heightInMM, widthInMM | corda | Não | Tamanho em mm (10-200). |
| heightInPx, widthInPx | corda | Não | Tamanho em pixels (20-600). |
| marginXInMM, marginYInMM, marginXInPx, marginYInPx | corda | Não | Margens em mm ou px. |
| opacity | inteiro | Não | 0-100. |
| isBackground | booleano | Não | Coloque o selo no fundo. |
| showOnlyInPrint | booleano | Não | Exibir somente na impressão. |
| async | booleano | Não | Ativar o processamento assíncrono. |
Quando usar Adicionar Carimbo de Imagem para PDF
- MarcaAdicione o logotipo ou carimbo da empresa a todas as páginas ou a páginas selecionadas.
- Direitos autorais e marcas d'águaUtilize uma imagem semitransparente para desencorajar a cópia.
- Selos de statusAdicione “RASCUNHO”, “APROVADO” ou “CONFIDENCIAL” como uma imagem.
- Certificação: Carimbar um selo ou emblema em documentos certificados.
Para esquemas de requisição/resposta e exemplos de código, consulte Carimbo de imagem 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 para o selo (PNG, JPG, etc.)
Formato de resposta
O API retorna um PDF Documento com o carimbo de imagem aplicado às páginas especificadas.