java rest api on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/pt/tag/java-rest-api/ Recent content in java rest api on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io pt Wed, 23 Sep 2026 13:04:19 +0000 Adicionar sobreposição de texto a GIF usando REST em Java https://blog-qa.groupdocs.cloud/pt/watermark/add-text-overlay-to-gif-using-rest-in-java/ Wed, 23 Sep 2026 13:04:19 +0000 https://blog-qa.groupdocs.cloud/pt/watermark/add-text-overlay-to-gif-using-rest-in-java/ Aprenda como adicionar sobreposição de texto a GIFs usando GroupDocs.Watermark Cloud SDK for Java via REST API. Inclui código, cURL e etapas de configuração agora. Comece rapidamente. Adicionar legendas dinâmicas, subtítulos ou mensagens promocionais a GIFs animados é uma necessidade comum para aplicações web e móveis modernas. GroupDocs.Watermark Cloud SDK for Java fornece uma poderosa biblioteca baseada em REST que torna essa tarefa simples. Neste guia você aprenderá como adicionar sobreposição de texto a GIF usando REST em Java, ver uma implementação completa em Java, explorar comandos cURL equivalentes e entender as etapas de configuração necessárias.

Adicionar Sobreposição de Texto a GIF Usando REST em Java - Código de Exemplo

Este exemplo demonstra como configurar uma marca d’água de texto e aplicá‑la a cada quadro de um arquivo GIF.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.client.Configuration;
import com.groupdocs.watermark.cloud.model.AddWatermarkRequest;
import com.groupdocs.watermark.cloud.model.AddWatermarkResponse;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.OutputFileInfo;
import com.groupdocs.watermark.cloud.model.TextWatermarkOptions;
import com.groupdocs.watermark.cloud.model.HorizontalAlignment;
import com.groupdocs.watermark.cloud.model.VerticalAlignment;

public class AddTextOverlayToGif {
    public static void main(String[] args) {
        // Initialize API configuration (replace with your actual clientId and clientSecret)
        Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(config);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.gif");          // Path to the source GIF in the storage
        inputFile.setStorageName("MyStorage");       // Optional: name of the storage

// Prepare output file information
        OutputFileInfo outputFile = new OutputFileInfo();
        outputFile.setFilePath("output.gif");        // Desired path for the watermarked GIF
        outputFile.setStorageName("MyStorage");      // Optional: name of the storage

// Configure text watermark options
        TextWatermarkOptions textOptions = new TextWatermarkOptions();
        textOptions.setText("Sample Watermark");
        textOptions.setFontFamily("Arial");
        textOptions.setFontSize(24.0);
        textOptions.setColor("#FF0000");             // Red color in HEX
        textOptions.setOpacity(0.5);                 // 50% opacity
        textOptions.setRotationAngle(0.0);
        textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
        textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
        textOptions.setPageRange("1-");               // Apply to all frames/pages

// Build the request
        AddWatermarkRequest request = new AddWatermarkRequest();
        request.setFileInfo(inputFile);
        request.setOutputFileInfo(outputFile);
        request.setOptions(textOptions);

try {
            // Execute the request
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (ApiException e) {
            System.err.println("Error while 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 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.

Sobrepor Texto em GIF com API REST Usando cURL

Abaixo estão os comandos cURL que executam a mesma operação a partir de um terminal. Eles ilustram o fluxo de trabalho completo da API REST: autenticação, upload, marca d’água e download.

# 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"}'

Substitua YOUR_ACCESS_TOKEN nas chamadas a seguir pelo token retornado acima.

# 2. Upload the source GIF to storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @path/to/local/input.gif

# 3. Add text overlay to the GIF
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.gif", "storageName": "MyStorage" },
           "outputFileInfo": { "filePath": "output.gif", "storageName": "MyStorage" },
           "options": {
               "text": "Sample Watermark",
               "fontFamily": "Arial",
               "fontSize": 24,
               "color": "#FF0000",
               "opacity": 0.5,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Middle",
               "pageRange": "1-"
           }
         }'

# 4. Download the watermarked GIF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o path/to/local/output.gif

Para mais detalhes sobre os corpos de requisição e formatos de resposta, veja a documentação oficial da API.

Desmembrando a Adição de Sobreposição de Texto a GIF Usando REST em Java - Como Funciona

  1. Inicializar o cliente da API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") cria um objeto de configuração que contém suas credenciais. A instância WatermarkApi usa essa configuração para assinar cada solicitação.
Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(config);

  1. Especifique os arquivos de origem e destino - FileInfo e OutputFileInfo informam ao serviço onde ler o GIF original e onde gravar o resultado. Ambos podem referenciar um nome de armazenamento personalizado.

    FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.gif");
inputFile.setStorageName("MyStorage");

  2. Configure a marca d’água de texto - TextWatermarkOptions contém todas as propriedades visuais: texto, fonte, tamanho, cor, opacidade, rotação e alinhamento. Definir pageRange como "1-" garante que cada quadro do GIF animado receba a sobreposição.

TextWatermarkOptions textOptions = new TextWatermarkOptions();
textOptions.setText("Sample Watermark");
textOptions.setFontFamily("Arial");
textOptions.setFontSize(24.0);
textOptions.setColor("#FF0000");
textOptions.setOpacity(0.5);
textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
textOptions.setPageRange("1-");
  1. Construa e envie a solicitação - AddWatermarkRequest agrupa as informações do arquivo e as opções. Chamando watermarkApi.addWatermark(request) executa a operação no servidor e retorna o caminho do arquivo processado.
AddWatermarkRequest request = new AddWatermarkRequest();
request.setFileInfo(inputFile);
request.setOutputFileInfo(outputFile);
request.setOptions(textOptions);
AddWatermarkResponse response = watermarkApi.addWatermark(request);
  1. Manipular a resposta - A resposta contém o caminho do arquivo de saída. Em uma aplicação real, você normalmente faria o download do arquivo ou passaria o caminho para outro serviço.

Para obter uma lista completa de classes e propriedades, consulte a referência da API.

Instalando e Configurando GroupDocs.Watermark Cloud SDK for Java

Adicione a dependência Maven ao seu pom.xml (ou a entrada equivalente do Gradle). Isso traz a versão 23.8 do SDK.

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

Pré-requisitos

  • Java 8 ou superior
  • Uma conta ativa do GroupDocs Cloud
  • Client ID e Client Secret (disponíveis no painel do GroupDocs Cloud)

Exemplo de Configuração

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Baixe os JARs mais recentes na página de download. Para uso em produção, aplique uma licença válida obtida na página de licença temporária.

Conclusão

Adicionar sobreposição de texto a GIF usando REST em Java se torna uma operação repetível, do lado do servidor, com a ajuda do GroupDocs.Watermark Cloud SDK for Java. O SDK abstrai as complexidades de manipular quadros animados, permitindo que você se concentre no conteúdo de suas legendas ou mensagens promocionais. Após integrar o código de exemplo ou o fluxo de trabalho cURL, você pode ajustar finamente estilos de fonte, cores e opacidade para combinar com sua marca. Lembre‑se de garantir uma licença de produção; detalhes de preços estão disponíveis na página do produto, e uma licença temporária pode ser obtida para testes através da página de licença temporária. Feliz codificação!

Perguntas Frequentes

  • Como adiciono sobreposição de texto a um GIF usando REST em Java quando o texto muda por usuário?
    Construa o objeto TextWatermarkOptions em tempo de execução com a string específica do usuário e, em seguida, invoque a mesma chamada addWatermark. A API processa cada solicitação de forma independente, portanto, o conteúdo dinâmico é totalmente suportado.

  • Posso adicionar legendas a um GIF animado sem afetar a velocidade da animação?
    Sim. A marca d’água é aplicada a cada quadro enquanto preserva o atraso original do quadro. Basta definir pageRange como "1-" para que cada quadro receba a mesma sobreposição.

  • Quais formatos são suportados para a cor do texto sobreposto?
    O SDK aceita códigos de cores HEX (por exemplo, #FF0000) e nomes de cores padrão do HTML. Consulte a referência da API para a lista completa.

  • Preciso de uma licença para desenvolvimento e teste?
    Uma licença temporária é suficiente para avaliação e teste. Para implantações de produção, adquira uma licença completa na página do produto e aplique‑a usando a API de licenciamento do SDK.

Read More

]]> Proteger Excel com senha via REST em Java https://blog-qa.groupdocs.cloud/pt/merger/password-protect-excel-via-rest-in-java/ Fri, 04 Sep 2026 12:18:34 +0000 https://blog-qa.groupdocs.cloud/pt/merger/password-protect-excel-via-rest-in-java/ Aprenda como proteger por senha uma pasta de trabalho do Excel via REST em Java usando o GroupDocs.Merger Cloud SDK. Guia passo a passo, exemplo de código e comandos cURL incluídos. Ocultar dados sensíveis em pastas de trabalho do Excel é uma necessidade comum para empresas que compartilham relatórios internamente ou com parceiros. GroupDocs.Merger Cloud SDK for Java permite que desenvolvedores adicionem proteção por senha a arquivos XLSX por meio de uma API REST simples. Neste guia, você aprenderá como implementar Proteção por senha do Excel via REST em Java, verá um exemplo completo em Java e executará comandos cURL equivalentes para integração na nuvem.

Pré-requisitos e Configuração

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

  • Java 8 ou superior instalado.
  • Maven ou Gradle para gerenciamento de dependências.
  • Uma conta do GroupDocs Cloud com client ID e client secret.
  • Acesso ao armazenamento em nuvem onde os arquivos Excel residirão.

Adicione a dependência Maven ao seu pom.xml (ou o snippet equivalente do Gradle):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Você pode baixar os JARs mais recentes na página de download. Após adicionar a dependência, crie um objeto de configuração com suas credenciais:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Com o cliente pronto, você pode prosseguir para o fluxo de trabalho real de proteção por senha.

Proteger Excel com senha via REST em Java: Guia passo a passo

Etapa 1: Carregar o Documento de Origem

Defina a localização do arquivo XLSX de origem em seu armazenamento em nuvem.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Etapa 2: Defina o caminho de destino

Especifique onde a pasta de trabalho protegida será salva.

String outputPath = "output_protected.xlsx"; // destination file

Etapa 3: Configurar Opções de Proteção por Senha

Crie um objeto ProtectOptions, anexe as informações do arquivo, o caminho de saída e a senha desejada.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Etapa 4: Construir a solicitação de proteção de documento

Envolva as opções em um ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Etapa 5: Executar a solicitação e tratar a resposta

Chame o método da API e processe quaisquer erros.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Para mais detalhes sobre cada classe, consulte a referência da API.

Exemplo completo em funcionamento para proteger Excel com senha via REST em Java

O código a seguir demonstra o processo completo do início ao fim.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

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.xlsx, output_protected.xlsx) para corresponderem às localizações reais dos seus arquivos, 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.

Proteger Pasta de Trabalho Excel via API REST usando cURL

A seguir está um conjunto de comandos cURL que executam a mesma operação de proteção por senha diretamente nos endpoints REST.

1. Autentique-se e 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 que você usará nas chamadas subsequentes.

2. Carregue o arquivo XLSX de origem

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Solicitar proteção por senha

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Baixe a pasta de trabalho protegida

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Esses comandos permitem integrar o fluxo de trabalho de proteção em scripts ou pipelines de CI. Para mais detalhes, veja a documentação oficial da API.

Conclusão

Implementar Proteção por senha do Excel via REST em Java é simples com o GroupDocs.Merger Cloud SDK for Java. Seguindo os passos acima, você pode proteger pastas de trabalho do Excel, automatizar o processo em aplicações lado do servidor e manter os dados sensíveis seguros. Lembre‑se de adquirir uma licença adequada para uso em produção; informações de preços estão disponíveis na página do produto e você pode começar com uma licença temporária para avaliar a biblioteca. Feliz codificação!

Perguntas Frequentes

  • Como a proteção por senha do Excel via REST em Java difere da criptografia local?
    A API em nuvem realiza a criptografia no servidor, portanto você não precisa gerenciar bibliotecas criptográficas localmente. O SDK cuida da construção da solicitação e da análise da resposta, simplificando a integração.

  • É possível definir opções de proteção adicionais, como modo somente‑leitura?
    A classe atual ProtectOptions foca na proteção por senha. Para recursos de segurança mais avançados, consulte a referência da API para quaisquer parâmetros mais recentes.

  • Quais formatos de arquivo são suportados para proteção por senha?
    A API Merger atualmente suporta XLSX, DOCX, PPTX, e PDF para criptografia. Consulte a documentação oficial para a lista completa.

  • Preciso de uma licença para executar o exemplo em um ambiente de desenvolvimento?
    Desenvolvimento e testes podem ser realizados com uma licença temporária. Implantações em produção exigem uma licença paga, que pode ser adquirida através da página do produto.

Leia Mais

]]>