Marca d'água

Bem‑vindo à documentação da API Watermark — uma solução simplificada que permite incorporar texto de marca d'água personalizado diretamente em uma ampla variedade de formatos de planilha com uma única requisição amigável ao desenvolvedor. Seja trabalhando com arquivos Microsoft Excel (.xlsx, .xls, .xlsm), arquivos CSV e TSV clássicos, Apple Numbers (.numbers) ou muitos outros tipos suportados, nossa API cuida do trabalho pesado para você. Basta enviar o arquivo fonte, fornecer o texto da marca d'água desejado e deixar que nosso serviço seguro e de alto desempenho retorne uma versão com marca d'água pronta para distribuição. Essa capacidade é perfeita para adicionar logotipos de marca, identificadores de versão, avisos de confidencialidade ou qualquer rótulo personalizado que reforçe o controle e a autenticidade dos documentos em sua organização.

Principais Funcionalidades

Projetada com velocidade e segurança em seu núcleo, a API Watermark integra‑se perfeitamente a qualquer fluxo de trabalho existente, seja você está construindo uma plataforma SaaS baseada na nuvem, uma ferramenta interna de gerenciamento de arquivos ou um pipeline automatizado de relatórios. O endpoint aceita uploads multipart, valida a integridade dos arquivos e aplica a marca d'água com precisão, garantindo que o layout original dos dados permaneça inalterado enquanto o texto adicional fique claramente visível. Por ser desenvolvida para desenvolvedores, você encontrará mensagens de erro claras, códigos de resposta abrangentes e exemplos detalhados ao longo deste guia. Explore como uma única chamada de API pode proteger suas planilhas, melhorar a consistência da marca e simplificar o gerenciamento do ciclo de vida dos documentos.

Documentos

Parâmetros

AppRequest.WatermarkText: Se você quiser usar preenchimento de cor RGB neste input, caso contrário use cor Hex
AppRequest.WatermarkColorHex: Se você quiser usar preenchimento de cor RGB neste input, caso contrário use cor Hex
AppRequest.WatermarkTextRGB: Se você quiser usar preenchimento de cor RGB neste input, caso contrário use cor Hex
UploadFileRequest.OperationId: Este é um ID de operação
UploadFileRequest.Files: Estes são os arquivos que você precisa enviar para nossos serviços online; você pode preparar os dados da sua maneira, mas deve seguir o padrão do input file HTML.

Usar o Endpoint

Envie uma requisição que inclua os arquivos e o token de acesso API de Marca d'água

curl -X 'POST' \ 'https://api.sheetize.cloud/watermark' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.WatermarkText=TheWatermarkText' \ -F 'AppRequest.WatermarkColorHex=ff0000' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
O serviço responderá com uma URL de download para o arquivo processado; neste exemplo é:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Envie uma requisição que inclua o nome do arquivo e o nome da pasta para API de Download

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Você receberá o arquivo e pode usá‑lo ou simplesmente encaminhá‑lo para a próxima etapa do seu fluxo de trabalho.