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

Adicionar marca d'água de texto ao Word - Marca d'água de texto API

PDF4me Adicionar marca d'água de texto ao Word Permite adicionar marcas d'água de texto personalizáveis a documentos do Word com controle abrangente de estilo e posicionamento. API O serviço processa arquivos do Word e adiciona marcas d'água de texto com controle total sobre o conteúdo do texto, família da fonte, tamanho da fonte, cores, ângulos de rotação, predefinições de orientação e níveis de transparência. API recebe conteúdo de documento Word através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para etiquetas de segurança, elementos de marca, avisos de confidencialidade e marcadores de status, esta solução é ideal para fluxos de trabalho de segurança de documentos, proteção de marca e indicação de status.

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 de textoMarcas d'água de texto profissionais com qualquer conteúdo de texto personalizado.
  • Personalização de fontesControle total sobre a família da fonte, o nome da fonte e o tamanho da fonte.
  • Opções de coresCores nomeadas, códigos hexadecimais, valores RGB e suporte a hexadecimal de 3 dígitos.
  • Controle de RotaçãoÂngulos de rotação personalizados (0-360°) ou predefinições de orientação.
  • Opções de transparênciaEfeitos de marca d'água semitransparentes ou totalmente opacos
  • Dimensionamento automáticoDimensionamento inteligente baseado no comprimento do texto e no tamanho da fonte.
  • Aplicação em todo o documentoMarcas d'água aplicadas a todas as seções e cabeçalhos.
  • Posicionamento do texto atrásMarcas d'água posicionadas atrás do conteúdo do documento

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 marca d'água de texto são realizadas por meio de um único ponto de extremidade:

  • Método: POST
  • Ponto final: office/ApiV2Word/AddTextWatermark

REST API Parâmetros​

Lista completa de parâmetros para Adicionar Marca d'água de Texto ao Word 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
documento*ObjectDescrição do documento. Deve incluir Nome (string): nome do arquivo Word de saída com extensão .docx{ "Name": "document.docx" }
conteúdo do documento*Base64Conteúdo do documento Word codificado em Base64UEsDBBQABgAIAAAA...
texto da marca d'água*StringTexto a ser exibido como marca d'água. Obrigatório - não pode ser nulo, vazio ou conter apenas espaços em branco. Exemplos: "CONFIDENCIAL", "RASCUNHO", "APROVADO"CONFIDENTIAL

Parâmetros opcionais​

ParâmetroTipoDescriçãoExemplo
família de fontesStringFamília de fontes para o texto da marca d'água. Comuns: "Arial", "Calibri", "Times New Roman", "Helvetica". Padrão: "Arial".Arial
tamanho da fonteNumber (dobro)Tamanho da fonte em pontos (de 1 a 1000). Padrão: 7272
cor da fonteStringCor do texto. Nomeado: "Vermelho", "Azul", "Cinza". Hexadecimal: "#FF0000", "FF0000". RGB: "RGB(255,0,0)". Padrão: "#808080"#FF0000
semitransparenteBooleanTransparência. true = opacidade 50%, false = 100% (padrão)true
rotaçãoNumber (dobro)Ângulo de rotação personalizado (0-360°). Padrão: 045
nome da fonteStringNome da fonte para o texto da marca d'águaArial
orientaçãoStringOrientação predefinida: Horizontal (0°), Vertical (90°), Diagonal (45°), De cabeça para baixo (180°). Substitui a rotação, se fornecida.Diagonal
nome_da_culturaStringCódigo de cultura (por exemplo, "en-US", "de-DE", "fr-FR"). Padrão: nuloen-US

Opções de orientação do texto​

A orientação do texto da marca d'água segue esta prioridade de parâmetro:

  1. orientação - Se fornecido, utiliza o ângulo de orientação predefinido.
  2. rotação - Se a orientação não for fornecida, utiliza o ângulo de rotação personalizado.
  3. Padrão - Se nenhuma das opções for fornecida, usa-se 0° (horizontal)

Orientações predefinidas:​

  • Horizontal: 0° (padrão)
  • Vertical: 90°
  • Diagonal: 45°
  • De cabeça para baixo: 180°

Saída​

O PDF4me Adicionar marca d'água de texto ao Word REST API retorna um JSON resposta (ApiV2WordApiCallRes). Em caso de sucesso, API retorna o documento Word como um Base64string codificada no document campo, não como dados binários.

Resposta bem-sucedida

Código de status: 200 OK

Tipo de conteúdo: application/json

Corpo da resposta:

{
  "document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "fileName": "document.docx",
  "success": true,
  "errorMessage": null
}

Campos de resposta:

  • documento (string): O documento do Word com a marca d'água de texto aplicada, codificado como Base64
  • nome_do_arquivo (string): O nome do arquivo Word de saída
  • sucesso (booleano): Indica se a operação foi bem-sucedida
  • mensagem de erro (string): Mensagem de erro se sucesso for falso; caso contrário, nulo

Como usar:

  1. Verificar success; se verdadeiro, extraia o document campo do JSON resposta
  2. Decifre o Base64 string para obter os dados binários do documento Word
  3. Salve ou processe o arquivo do Word usando fileName

Exemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
if (!data.success) throw new Error(data.errorMessage);
const wordBytes = atob(data.document);
// Save or process wordBytes

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):

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "CONFIDENTIAL"
}

Exemplo avançado (com campos opcionais):

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "CONFIDENTIAL",
  "orientation": "Diagonal",
  "fontFamily": "Arial",
  "fontSize": 72,
  "fontColor": "#FF0000",
  "semiTransparent": true,
  "cultureName": "en-US"
}

Exemplo de rotação personalizada:

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "DRAFT",
  "fontFamily": "Times New Roman",
  "fontSize": 48,
  "fontColor": "Gray",
  "rotation": 45,
  "semiTransparent": true
}

Exemplos de código​

O PDF4me Adicionar marca d'água de texto ao Word 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 marcas d'água de texto a documentos do Word:

Casos de uso e aplicações industriais​

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

  • Documentos Confidenciais: Adicione marcas d'água "CONFIDENCIAL" a documentos legais.
  • Minutas de ContratosMarque os contratos preliminares com o status "PRELIMINAR - EM ANÁLISE".
  • Rótulos de privilégioAplicar marcas d'água de texto "PRIVILÉGIO ADVOGADO-CLIENTE"
  • Marcadores de statusIndique o status "APROVADO" ou "PENDENTE DE ANÁLISE".

Obtenha ajuda​

Get Your API KeyAPI SamplesGetting Started