Exemplo completo em funcionamento para remover objetos de anotação de PDF com REST em Node.JS

Este exemplo demonstra como fazer upload de um PDF, excluir todas as suas anotações e baixar o arquivo limpo usando o GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivos e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Excluir Anotações de PDF via API REST usando cURL

A seguir estão os comandos cURL que executam o mesmo fluxo de remoção de anotações através dos endpoints REST do GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Para obter uma lista completa de endpoints e parâmetros, consulte a documentação oficial da API.

Como remover objetos de anotação de PDF com REST em Node.JS funciona

1. Configuração de Autenticação - A classe Configuration é instanciada com seu clientId e clientSecret, criando um contexto autenticado para todas as chamadas subsequentes da API.

   const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
   

2. Upload de Arquivo - UploadFileRequest envia os bytes do PDF local para o armazenamento do GroupDocs Cloud. O método storageApi.uploadFile lida com a transferência.

   const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
       path: remoteFilePath,
       file: fileBytes
   });
   await storageApi.uploadFile(uploadRequest);
   

3. Recuperar Anotações - GetAnnotationsRequest cria um objeto de requisição com uma referência FileInfo. A chamada annotationsApi.getAnnotations retorna uma coleção de objetos de anotação, dos quais os IDs são extraídos.

   const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
       fileInfo: fileInfo
   });
   const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
   

4. Excluir Anotações - Se houver IDs, DeleteAnnotationsRequest é preenchido e passado para annotationsApi.deleteAnnotations, que remove permanentemente as anotações do PDF armazenado.

   const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
       fileInfo: fileInfo,
       annotationIds: annotationIds
   });
   await annotationsApi.deleteAnnotations(deleteRequest);
   

5. Baixar PDF Limpo - Por fim, DownloadFileRequest obtém o arquivo atualizado, e fs.writeFileSync grava‑o no sistema de arquivos local.

   const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
       path: remoteFilePath
   });
   const fileStream = await storageApi.downloadFile(downloadRequest);
   fs.writeFileSync(localOutputPath, fileStream);
   

Para definições detalhadas de classes e métodos, consulte a referência da API.

Instalando e Configurando GroupDocs.Annotation Cloud SDK for Node.js

O SDK é distribuído como um pacote npm. Instale‑o com o comando abaixo e, em seguida, importe‑o em seu projeto.

npm install groupdocs-annotation-cloud

Você também pode baixar o pacote mais recente diretamente da página de lançamentos do GitHub ou do URL oficial de download.

Após a instalação, importe a biblioteca e crie um objeto de configuração conforme mostrado no exemplo de código:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Certifique-se de que seu ambiente de tempo de execução atenda aos requisitos de versão do Node.js e de que você possua uma conta válida do GroupDocs para obter as credenciais do cliente.

Opções e Configurações de Remoção de Anotações

O SDK expõe vários parâmetros que você pode ajustar:

• clientId / clientSecret - Credenciais para autenticação OAuth. Defina‑as no construtor Configuration.
• fileInfo.filePath - O caminho do PDF no armazenamento GroupDocs Cloud. Ajuste isso se você armazenar arquivos em uma pasta diferente.
• annotationIds - Uma matriz de IDs retornados por GetAnnotations. Fornecer um subconjunto permite exclusão seletiva.

Configurações adicionais, como tempos limite de solicitação e configuração de proxy, estão disponíveis na documentação do SDK; veja a documentação oficial para a lista completa.

Melhores práticas para remover anotações de PDF via REST

• Validar IDs de Anotação - Sempre verifique se os IDs que você pretende excluir existem; tentar excluir IDs inexistentes pode causar um erro 404.
• Usar HTTPS - Todas as chamadas de API devem ser feitas via HTTPS para proteger suas credenciais e os dados do documento.
• Lidar com Arquivos Grandes usando Uploads em Blocos - Para PDFs maiores que 100 MB, prefira o endpoint de upload multipart para evitar timeouts.
• Registrar Respostas da API - Armazene IDs de requisição e respostas para trilhas de auditoria e facilitar a solução de problemas.
• Reutilizar Tokens de Acesso - Cache o token OAuth até que expire para reduzir a sobrecarga de autenticação.

Perguntas Frequentes

• Como faço a autenticação com a API do GroupDocs.Annotation Cloud?
  Obtenha um ID de cliente e um segredo da sua conta GroupDocs, então solicite um token de acesso via o endpoint OAuth. Consulte a documentação oficial para mais detalhes.

• Posso excluir anotações específicas em vez de todas?
  Sim, forneça os IDs das anotações que deseja remover no DeleteAnnotationsRequest. O SDK retorna a lista de IDs de anotações após uma chamada GetAnnotations.

• Como posso remover objetos de Anotação de PDF com REST em Node.JS?
  Use o GroupDocs.Annotation Cloud SDK for Node.js para chamar o endpoint DeleteAnnotations após recuperar os IDs das anotações. O fluxo completo é demonstrado no exemplo de código e na seção cURL deste guia.

• Qual licença é necessária para uso em produção?
  É necessária uma licença paga para produção. Você pode adquirir uma licença temporária na página de licença temporária durante a avaliação.

Leitura adicional

• Extrair ou Remover Anotações de PDF usando API REST em Node.js
• Texto Tachado em um PDF com Node.js e API REST
• Remover Anotações de PDF usando API REST em Python

Antes de Começar: Pré-requisitos e Instalação

Antes de começar, certifique‑se de que você tem o seguinte:

• Node.js 14 ou posterior instalado na sua máquina de desenvolvimento.
• Uma conta ativa do GroupDocs Cloud com ID do cliente e segredo do cliente.
• Acesso aos arquivos PDF que você deseja combinar, armazenados no armazenamento do GroupDocs Cloud.

Instale o SDK via npm e baixe o pacote mais recente:

npm install groupdocs-merger-cloud

Você também pode obter o SDK na página oficial de lançamentos: Baixar SDK. Após a instalação, você está pronto para começar a programar.

Guia passo a passo para mesclar PDF em Node.JS

Etapa 1: Instalar SDK e Importar Classes Necessárias

Primeiro, importe as classes que você precisará para mesclar PDFs.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Esta importação fornece acesso à API principal, objetos de configuração e descritores de arquivo.

Etapa 2: Configure suas credenciais do GroupDocs

Crie um objeto de configuração com suas credenciais de cliente.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Fornecer as credenciais corretas permite que a biblioteca autentique suas solicitações.

Etapa 3: Definir os arquivos PDF a mesclar

Liste os documentos PDF que você deseja combinar. Esta etapa prepara você para mesclar PDFs no Node.JS de forma eficiente.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Cada FileInfo aponta para um arquivo armazenado em seu armazenamento do GroupDocs Cloud.

Etapa 4: Definir opções de mesclagem

Configure o local de saída e anexe a lista de arquivos ao merge request.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Essas configurações controlam como você mescla PDFs no Node.JS e onde o resultado será salvo.

Etapa 5: Executar a Operação de Mesclagem

Crie a instância da API, chame o método merge e trate a resposta.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

A chamada assíncrona retorna o caminho do documento mesclado se a operação for bem‑sucedida.

Exemplo de Implementação Completa para Mesclar PDFs em Node.JS

O código a seguir demonstra o fluxo de trabalho completo, desde a configuração até o tratamento do resultado.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Mesclando PDFs via API REST usando cURL

Se você preferir uma abordagem REST pura, a mesma operação pode ser realizada com comandos cURL.

Primeiro, obtenha um token de acesso:

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET","grant_type":"client_credentials"}'

Carregue os PDFs de origem no seu armazenamento (substitua YOUR_ACCESS_TOKEN pelo token da etapa anterior):

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

Repita o upload para input2.pdf. Em seguida, solicite a operação de mesclagem:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Finalmente, faça o download do arquivo mesclado:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

Para obter uma lista completa de endpoints e parâmetros, consulte a referência da API.

Configurando Opções de Mesclagem

O SDK expõe várias opções que permitem ajustar finamente o processo de mesclagem:

• outputPath - Caminho de destino para o PDF mesclado. Ajuste isso para controlar onde o resultado será armazenado.
• fileInfos - Uma matriz de objetos FileInfo que definem os PDFs de origem e sua ordem.

Você também pode definir propriedades adicionais, como pages para mesclar intervalos de páginas específicos, ou password para PDFs criptografados. Consulte a documentação oficial para a lista completa de campos configuráveis.

Considerações de desempenho ao mesclar PDFs

Ao mesclar PDFs grandes ou muitos arquivos PDF, mantenha estas dicas em mente:

• Use async/await para evitar bloquear o loop de eventos, especialmente para documentos grandes.
• Batch uploads: envie PDFs de origem em paralelo antes de invocar a mesclagem para reduzir a latência geral.
• Streamed processing: para PDFs extremamente grandes, considere armazenar resultados intermediários em armazenamento em nuvem e mesclá‑los em blocos menores.
• Encrypted PDFs: forneça senhas nos objetos FileInfo; o processamento de arquivos criptografados adiciona sobrecarga, portanto mescle-os após a descriptografia quando possível.

Aplicar essas práticas ajuda a mesclar PDFs em Node.JS de forma eficiente, minimizando o consumo de memória.

Perguntas que você pode ter

• Como faço para mesclar arquivos PDF no Node.JS usando GroupDocs?
  Use o GroupDocs.Merger Cloud SDK for Node.js para criar uma instância MergeApi, configurar MergeOptions com seus PDFs de origem e chamar mergeDocuments. O exemplo completo de código neste guia demonstra o processo.

• Posso mesclar arquivos PDF criptografados no Node.JS?
  Sim, o SDK oferece suporte à mesclagem de PDFs criptografados. Forneça as senhas corretas nos objetos FileInfo antes de chamar mergeDocuments. Consulte a documentação oficial para obter detalhes.

• Quais são as opções de licenciamento para GroupDocs.Merger?
  GroupDocs oferece planos de preços flexíveis. Para testes, você pode solicitar uma licença temporária para avaliar a biblioteca antes de adquirir uma assinatura completa.

• Onde posso encontrar mais exemplos e suporte?
  Amostras adicionais estão disponíveis no repositório GitHub. Para obter ajuda, visite o fórum de suporte.

Leitura adicional

• Dividir PDF em vários PDFs no Node.JS
• Bloquear documentos PDF com senhas usando API REST no Node.js
• Como mesclar arquivos PDF em C# usando API REST

Adicionar Marca d’água de Imagem a Documentos PDF em Java em 5 Etapas

1. Inicializar o cliente da API: Crie uma instância ApiClient com seu ID de cliente e segredo.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

Esta etapa conecta seu código Java ao serviço GroupDocs.Watermark Cloud. Consulte a referência da API para mais detalhes.

2. Especifique o arquivo PDF de origem: Crie um objeto FileInfo que aponta para o PDF que você deseja marcar com marca d’água.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

O arquivo deve ser enviado para o seu armazenamento GroupDocs antes da solicitação.

3. Configure a marca d’água de imagem: Defina o caminho da imagem, opacidade, fator de escala, rotação e alinhamento.

   ImageWatermark imageWatermark = new ImageWatermark();
   imageWatermark.setImagePath("watermark.png");
   imageWatermark.setOpacity(0.5);
   imageWatermark.setScaleFactor(0.3);
   imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
   imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
   imageWatermark.setMargin(new Margin(10, 10, 10, 10));
   

   Ajuste esses valores para obter a aparência desejada; a opacidade controla a transparência, enquanto o scaleFactor determina o tamanho relativo à página.

4. Defina as opções de marca d’água e o caminho de saída: Combine as informações do arquivo e a marca d’água em um objeto WatermarkOptions.

   WatermarkOptions options = new WatermarkOptions();
   options.setFileInfo(fileInfo);
   options.setImageWatermark(imageWatermark);
   options.setOutputPath("output.pdf");
   

   O outputPath indica ao serviço onde armazenar o PDF resultante.

5. Execute a solicitação: Crie um AddWatermarkRequest e chame a API. Trate respostas de sucesso ou erro.

AddWatermarkRequest request = new AddWatermarkRequest(options);
try {
    AddWatermarkResponse response = watermarkApi.addWatermark(request);
    System.out.println("Watermark added successfully. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error adding watermark: " + e.getMessage());
}

Após a execução, o PDF com marca d’água está disponível no local que você especificou.

Exemplo de Código Completo: Adicionar Marca d’água de Imagem a Documentos PDF em Java

O exemplo a seguir demonstra a implementação completa, desde a inicialização do cliente até a gravação do PDF com marca‑d’água.

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (input.pdf, watermark.png, output.pdf) para corresponderem às suas localizações reais, verifique se todas as dependências necessárias estão corretamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Aplicar Marca d’Água de Imagem em Documentos PDF via cURL e API REST

Abaixo estão as chamadas REST que você pode usar com cURL para obter o mesmo resultado sem escrever código Java.

1. Obtenha um token de acesso

   curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
   

   A resposta contém um access_token usado nas chamadas subsequentes.

2. Carregue o PDF de origem

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"
   

3. Carregue a imagem da marca d’água

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/watermark.png"

4. Adicionar a marca d’água de imagem

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

Esta solicitação reflete a lógica do código Java, aplicando as mesmas configurações de opacidade, escala e alinhamento.

5. Baixe o PDF com marca d’água

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Para mais detalhes sobre os corpos de solicitação e parâmetros suportados, veja a documentação oficial da API.

Instalando e Configurando GroupDocs.Watermark Cloud SDK for Java

Adicione a dependência Maven ao seu pom.xml (ou o trecho equivalente do Gradle). A biblioteca está hospedada no Maven Central.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Você também precisa de uma conta válida do GroupDocs Cloud. Recupere seu Client ID e Client Secret no portal do GroupDocs. Nenhuma instalação adicional de tempo de execução é necessária porque o SDK se comunica com o serviço em nuvem.

Ajuste fino das opções de marca d’água de imagem para documentos PDF

O SDK expõe várias propriedades que permitem controlar a aparência visual da marca d’água.

Ajustar Opacidade

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

Os valores de opacidade variam de 0.0 (totalmente transparente) a 1.0 (totalmente opaco).

Alterar Fator de Escala

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

O fator de escala determina o tamanho da marca d’água em relação às dimensões da página.

Definir alinhamento e margens

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

Essas configurações posicionam a marca d’água no canto inferior direito com uma margem de 20 pontos.

Para obter uma lista completa de propriedades configuráveis, consulte a referência da API.

Conclusão

Adicionar uma marca d’água de imagem a documentos PDF em Java é uma tarefa simples quando você usa o GroupDocs.Watermark Cloud SDK for Java. O SDK lida com toda a manipulação de PDF de baixo nível, permitindo que você se concentre nos aspectos visuais, como opacidade, dimensionamento e posicionamento. Seja qual for a sua preferência por uma implementação Java nativa ou um fluxo de trabalho baseado em cURL na nuvem, os mesmos resultados de alta qualidade são alcançáveis sem sacrificar o desempenho. Lembre‑se de obter uma licença adequada para uso em produção; detalhes de preços estão disponíveis na página do produto e uma página de licença temporária pode ser usada para avaliação.

Perguntas Frequentes

• Como adiciono marca d’água de imagem a um PDF em Java sem perder qualidade?
  Use a propriedade scaleFactor para dimensionar a marca d’água em relação à página e manter o DPI original do PDF de origem. O SDK preserva a resolução do PDF, de modo que a marca d’água permanece nítida em qualquer nível de zoom.

• Posso adicionar várias marcas d’água ao mesmo PDF?
  Sim. Crie objetos ImageWatermark separados com configurações diferentes e adicione‑os sequencialmente chamando addWatermark várias vezes ou adicionando‑os a uma lista na solicitação.

• Quais são os formatos de imagem suportados para a marca d’água?
  A API aceita tipos de imagem comuns, como PNG, JPG, BMP, GIF e TIFF. PNG é recomendado para qualidade sem perdas e suporte a transparência.

• Existe uma maneira de visualizar a marca d’água antes de aplicá‑la?
  Você pode usar o GroupDocs.Watermark Cloud SDK for Java para gerar um PDF temporário com a marca d’água e baixá‑lo para revisão. Isso usa a mesma chamada addWatermark com um caminho de saída apontando para um local temporário.

Read More

• Adicionar marca d’água a imagens usando Java
• Adicionar marca d’água ao Word em Java - Watermark Creator
• Adicionar marca d’água de imagem ao PDF | Como adicionar marca d’água a documentos PDF usando .NET