java rest api on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/tag/java-rest-api/ Recent content in java rest api on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io en Wed, 23 Sep 2026 13:04:19 +0000 Add Text Overlay to GIF using REST in Java https://blog-qa.groupdocs.cloud/watermark/add-text-overlay-to-gif-using-rest-in-java/ Wed, 23 Sep 2026 13:04:19 +0000 https://blog-qa.groupdocs.cloud/watermark/add-text-overlay-to-gif-using-rest-in-java/ Learn how to add text overlay to GIFs using GroupDocs.Watermark Cloud SDK for Java via REST API. Includes code, cURL and setup steps now. Start quickly. Adding dynamic captions, subtitles, or promotional messages to animated GIFs is a common need for modern web and mobile applications. GroupDocs.Watermark Cloud SDK for Java provides a powerful REST‑based library that makes this task straightforward. In this guide you will learn how to add text Overlay to GIF using REST in Java, see a full Java implementation, explore equivalent cURL commands, and understand the required setup steps.

Add Text Overlay to GIF Using REST in Java - Sample Code

This example demonstrates how to configure a text watermark and apply it to every frame of a GIF file.

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();
        }
    }
}

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update any file paths and configuration values to match your actual environment, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

Overlay Text on GIF with REST API Using cURL

Below are the cURL commands that perform the same operation from a terminal. They illustrate the full REST workflow: authentication, upload, watermarking, and 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"}'

Replace YOUR_ACCESS_TOKEN in the following calls with the token returned above.

# 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

For more details on request bodies and response formats, see the official API documentation.

Breaking Down Add Text Overlay to GIF Using REST in Java - How It Works

  1. Initialize the API client - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") creates a configuration object that holds your credentials. The WatermarkApi instance uses this configuration to sign every request.

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

  2. Specify source and destination files - FileInfo and OutputFileInfo tell the service where to read the original GIF and where to write the result. Both can reference a custom storage name.

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

  3. Configure the text watermark - TextWatermarkOptions holds all visual properties: text, font, size, color, opacity, rotation, and alignment. Setting pageRange to "1-" ensures every frame of the animated GIF receives the overlay.

    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-");

  4. Build and send the request - AddWatermarkRequest bundles the file info and options. Calling watermarkApi.addWatermark(request) performs the operation on the server and returns the path of the processed file.

    AddWatermarkRequest request = new AddWatermarkRequest();
request.setFileInfo(inputFile);
request.setOutputFileInfo(outputFile);
request.setOptions(textOptions);
AddWatermarkResponse response = watermarkApi.addWatermark(request);

  5. Handle the response - The response contains the output file path. In a real application you would typically download the file or pass the path to another service.

For a full list of classes and properties, refer to the API reference.

Installing and Configuring GroupDocs.Watermark Cloud SDK for Java

Add the Maven dependency to your pom.xml (or the equivalent Gradle entry). This pulls in version 23.8 of the SDK.

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

Prerequisites

  • Java 8 or higher
  • An active GroupDocs Cloud account
  • Client ID and Client Secret (available in the GroupDocs Cloud dashboard)

Configuration Example

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

Download the latest JARs from the download page. For production use, apply a valid license obtained from the temporary license page.

Conclusion

Adding text Overlay to GIF using REST in Java becomes a repeatable, server‑side operation with the help of the GroupDocs.Watermark Cloud SDK for Java. The SDK abstracts the complexities of handling animated frames, letting you focus on the content of your subtitles or promotional messages. After integrating the sample code or the cURL workflow, you can fine‑tune font styles, colors, and opacity to match your brand. Remember to secure a production license pricing details are available on the product page, and a temporary license can be obtained for testing via the temporary license page. Happy coding!

FAQs

  • How do I add text Overlay to GIF using REST in Java when the text changes per user?
    Build the TextWatermarkOptions object at runtime with the user‑specific string, then invoke the same addWatermark call. The API processes each request independently, so dynamic content is fully supported.

  • Can I add subtitles to an animated GIF without affecting its animation speed?
    Yes. The watermark is applied to each frame while preserving the original frame delay. Just set pageRange to "1-" so every frame receives the same overlay.

  • What formats are supported for the overlay text color?
    The SDK accepts HEX color codes (e.g., #FF0000) and standard HTML color names. See the API reference for the complete list.

  • Do I need a license for development and testing?
    A temporary license is sufficient for evaluation and testing. For production deployments, purchase a full license from the product page and apply it using the SDK’s licensing API.

Read More

]]> Password Protect Excel via REST in Java https://blog-qa.groupdocs.cloud/merger/password-protect-excel-via-rest-in-java/ Fri, 04 Sep 2026 12:18:34 +0000 https://blog-qa.groupdocs.cloud/merger/password-protect-excel-via-rest-in-java/ Learn how to password protect an Excel workbook via REST in Java using GroupDocs.Merger Cloud SDK. Step-by-step guide, code sample, and cURL commands included. Concealing sensitive data in Excel workbooks is a common requirement for enterprises that share reports internally or with partners. GroupDocs.Merger Cloud SDK for Java enables developers to add password protection to XLSX files through a simple REST API. In this guide you will learn how to implement password Protect Excel via REST in Java, see a complete Java example, and run equivalent cURL commands for cloud integration.

Prerequisites and Setup

Before you begin, make sure you have the following:

  • Java 8 or higher installed.
  • Maven or Gradle for dependency management.
  • A GroupDocs Cloud account with client ID and client secret.
  • Access to the cloud storage where the Excel files will reside.

Add the Maven dependency to your pom.xml (or the equivalent Gradle snippet):

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

You can download the latest JARs from the download page. After adding the dependency, create a configuration object with your credentials:

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

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

With the client ready, you can move on to the actual password‑protect workflow.

Password Protect Excel via REST in Java: Step-by-Step Walkthrough

Step 1: Load the Source Document

Define the location of the source XLSX file inside your cloud storage.

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

Step 2: Set the Destination Path

Specify where the protected workbook will be saved.

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

Step 3: Configure Password Protection Options

Create a ProtectOptions object, attach the file info, output path, and the desired password.

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

Step 4: Build the Protect Document Request

Wrap the options in a ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Step 5: Execute the Request and Handle the Response

Call the API method and process any errors.

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());
}

For more details on each class, refer to the API reference.

Full Working Example for Password Protect Excel via REST in Java

The following code demonstrates the complete process from start to finish.

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());
        }
    }
}

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update the file paths (input.xlsx, output_protected.xlsx) to match your actual file locations, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

Protect Excel Workbook via REST API Using cURL

Below is a set of cURL commands that perform the same password‑protect operation directly against the REST endpoints.

1. Authenticate and 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"
         }'

The response contains an access_token that you will use in subsequent calls.

2. Upload the source XLSX file

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. Request password protection

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. Download the protected workbook

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

These commands let you integrate the protection workflow into scripts or CI pipelines. For more details, see the official API documentation.

Conclusion

Implementing password Protect Excel via REST in Java is straightforward with the GroupDocs.Merger Cloud SDK for Java. By following the steps above you can secure Excel workbooks, automate the process in server‑side applications, and keep sensitive data safe. Remember to acquire a proper license for production use; pricing information is available on the product page and you can start with a temporary license to evaluate the library. Happy coding!

FAQs

  • How does password Protect Excel via REST in Java differ from local encryption?
    The cloud API performs encryption on the server, so you don’t need to manage cryptographic libraries locally. The SDK handles request construction and response parsing, simplifying integration.

  • Is it possible to set additional protection options, such as read‑only mode?
    The current ProtectOptions class focuses on password protection. For more advanced security features, consult the API reference for any newer parameters.

  • What file formats are supported for password protection?
    The Merger API currently supports XLSX, DOCX, PPTX, and PDF for encryption. Refer to the official documentation for the full list.

  • Do I need a license to run the example in a development environment?
    Development and testing can be done with a temporary license. Production deployments require a paid license, which you can purchase through the product page.

Read More

]]>