Adicionar marca d'água de texto - Excel API
PDF4me Adicionar marca d'água de texto Permite adicionar marcas d'água de texto personalizáveis a Excel documentos com estilo de fonte, transparência e controle de posicionamento. Isto API processos de serviço Excel O programa adiciona marcas d'água de texto para etiquetas de segurança, identidade visual e avisos de confidencialidade. API recebe Excel conteúdo do documento através REST API chamadas, utilizando Base64 Codificação para transmissão segura. Essa solução é ideal para segurança de documentos, proteção da marca e fluxos de trabalho com indicação de status.
Autenticando seu API Solicitar
Inclua o seu API digite a chave na solicitação para autenticar com o PDF4me REST API.
Principais características
- Marcas d'água de texto personalizadasAdicione qualquer texto como marca d'água (por exemplo, "Confidencial", "RASCUNHO")
- Personalização de fontesControle a família, o tamanho e a cor da fonte.
- Controle de TransparênciaTexto semitransparente ou totalmente opaco
- Opções de posicionamentoPosicionamento e alinhamento de controle
REST API Ponto final
- Método: POST
- Ponto final:
office/ApiV2Excel/ExcelAddWatermark
REST API Parâmetros
Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios. Todas as solicitações usam documento, conteúdo do documento, e ação adicionar marca d'água ao ExcelOs parâmetros específicos da operação (watermarkText, fontFamily, etc.) são propriedades do objeto de ação.
Parâmetros obrigatórios (nível raiz)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| documento* | Object | Referência do documento com Nome (Excel nome do arquivo, .xlsx ou .xls) | { "Name": "data.xlsx" } |
| conteúdo do documento* | String (Base64) | Excel conteúdo do documento codificado em Base64 | UEsDBBQABgAIAAAA... |
| ação adicionar marca d'água ao Excel* | Object | Configuração de ação. Deve conter pelo menos texto da marca d'água (string): texto a ser exibido como marca d'água | Veja o exemplo de carga útil abaixo. |
Parâmetros opcionais (dentro de addWatermarkToExcelAction)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| família de fontes | String | Nome da família da fonte. Padrão: Arial | Arial |
| tamanho da fonte | Número | Tamanho da fonte em pontos. Padrão: 72 | 48 |
| cor da fonte | String | Cor hexadecimal ou nome da cor. Padrão: preto | #808080 |
| semitransparente | Boolean | verdadeiro = 50% de opacidade, falso = 100% (padrão) | true |
| nome_da_cultura | String | Código cultural para renderização de texto | en-US |
Saída
O API retorna o Excel documento como um Base64string codificada em JSON formato (documento, nomeDoArquivo, sucesso, mensagemDeErro).
Exemplo de solicitação
Cabeçalho
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carga útil (básica)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addWatermarkToExcelAction": {
"watermarkText": "Confidential"
}
}