java rest api on Document Processing REST APIs | GroupDocs Cloud

Додати текстове накладання до GIF за допомогою REST у Java

Wed, 23 Sep 2026 13:04:19 +0000

Додавання динамічних підписів, субтитрів або рекламних повідомлень до анімованих GIF‑зображень є поширеною потребою для сучасних веб‑ та мобільних застосунків. GroupDocs.Watermark Cloud SDK for Java надає потужну бібліотеку на базі REST, яка спрощує виконання цього завдання. У цьому посібнику ви дізнаєтеся, як додати текстове накладання до GIF за допомогою REST у Java, переглянути повну реалізацію на Java, вивчити еквівалентні команди cURL та зрозуміти необхідні кроки налаштування.

Додати текстову накладку до GIF за допомогою REST у Java - приклад коду

Цей приклад демонструє, як налаштувати текстовий водяний знак і застосувати його до кожного кадру 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();
        }
    }
}

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, що усі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь‑якими проблемами, будь ласка, зверніться до офіційної документації або звʼяжіться з командою підтримки для отримання допомоги.

Накласти текст на GIF за допомогою REST API з використанням cURL

Нижче наведено команди cURL, які виконують ту ж операцію з терміналу. Вони ілюструють повний процес REST: автентифікація, завантаження, додавання водяного знака та завантаження.

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

Замініть YOUR_ACCESS_TOKEN у наведених нижче викликах на токен, отриманий вище.

# 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

Для отримання докладнішої інформації про тіла запитів та формати відповідей, перегляньте офіційну документацію API.

Розбір процесу додавання текстового накладання до GIF за допомогою REST у Java - Як це працює

Ініціалізуйте клієнт API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") створює об’єкт конфігурації, який містить ваші облікові дані. Екземпляр WatermarkApi використовує цю конфігурацію для підписання кожного запиту.

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

Вкажіть вихідний та цільовий файли - FileInfo та OutputFileInfo повідомляють сервісу, де читати оригінальний GIF і куди записати результат. Обидва можуть посилатися на власну назву сховища.
```
FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.gif");
inputFile.setStorageName("MyStorage");
```
Налаштуйте текстовий водяний знак - TextWatermarkOptions містить усі візуальні властивості: текст, шрифт, розмір, колір, прозорість, обертання та вирівнювання. Встановлення pageRange в "1-" забезпечує, що кожен кадр анімованого GIF отримує накладення.

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

Створіть і надішліть запит - AddWatermarkRequest об’єднує інформацію про файл та параметри. Виклик watermarkApi.addWatermark(request) виконує операцію на сервері та повертає шлях до обробленого файлу.
```
AddWatermarkRequest request = new AddWatermarkRequest();
request.setFileInfo(inputFile);
request.setOutputFileInfo(outputFile);
request.setOptions(textOptions);
AddWatermarkResponse response = watermarkApi.addWatermark(request);
```
Обробка відповіді - Відповідь містить шлях до вихідного файлу. У реальному застосунку ви зазвичай завантажуєте файл або передаєте шлях іншій службі.

Для повного списку класів і властивостей зверніться до довідки API.

Встановлення та налаштування GroupDocs.Watermark Cloud SDK for Java

Додайте залежність Maven у ваш pom.xml (або відповідний запис Gradle). Це підключає версію 23.8 SDK.


    com.groupdocs
    groupdocs-watermark-cloud
    23.8

Вимоги

Java 8 або вище
Активний обліковий запис GroupDocs Cloud
Client ID та Client Secret (доступні в панелі управління GroupDocs Cloud)

Приклад конфігурації

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

Завантажте останні JAR‑файли зі сторінки завантаження. Для використання у продакшені застосуйте дійсну ліцензію, отриману зі сторінки тимчасової ліцензії.

Висновок

Додавання текстового накладання до GIF за допомогою REST у Java стає повторюваною сервер‑сторонньою операцією завдяки GroupDocs.Watermark Cloud SDK for Java. SDK абстрагує складність обробки анімованих кадрів, дозволяючи вам зосередитися на вмісті ваших субтитрів або рекламних повідомлень. Після інтеграції зразкового коду або cURL‑процесу ви можете точно налаштувати стилі шрифтів, кольори та прозорість, щоб відповідати вашому бренду. Не забудьте отримати ліцензію для продакшн; деталі ціноутворення доступні на сторінці продукту, а тимчасову ліцензію можна отримати для тестування через temporary license page. Щасливого кодування!

Питання та відповіді

Як додати текстове накладання до GIF за допомогою REST у Java, коли текст змінюється для кожного користувача?
Створіть об’єкт TextWatermarkOptions під час виконання з рядком, специфічним для користувача, а потім викличте той самий метод addWatermark. API обробляє кожен запит незалежно, тому динамічний вміст повністю підтримується.
Чи можу я додати субтитри до анімованого GIF, не впливаючи на швидкість анімації?
Так. Водяний знак застосовується до кожного кадру, зберігаючи оригінальну затримку кадру. Просто встановіть pageRange у "1-", щоб кожен кадр отримав однакове накладання.
Які формати підтримуються для кольору накладеного тексту?
SDK приймає HEX‑коди кольорів (наприклад, #FF0000) та стандартні назви кольорів HTML. Перегляньте довідку API для повного списку.
Чи потрібна мені ліцензія для розробки та тестування?
Тимчасова ліцензія достатня для оцінки та тестування. Для розгортання у продакшн придбайте повну ліцензію зі сторінки продукту та застосуйте її за допомогою API ліцензування SDK.

Читати далі

Захист Excel паролем через REST у Java

Fri, 04 Sep 2026 12:18:34 +0000

Приховування конфіденційних даних у Excel‑книгах є поширеною вимогою для підприємств, які діляться звітами всередині організації або з партнерами. GroupDocs.Merger Cloud SDK for Java дозволяє розробникам додавати захист паролем до файлів XLSX за допомогою простого REST API. У цьому посібнику ви дізнаєтеся, як реалізувати захист паролем Excel через REST у Java, переглянути повний приклад Java та виконати еквівалентні команди cURL для хмарної інтеграції.

Вимоги та налаштування

Перш ніж розпочати, переконайтеся, що у вас є наступне:

Встановлений Java 8 або новіша версія.
Maven або Gradle для керування залежностями.
Обліковий запис GroupDocs Cloud з client ID та client secret.
Доступ до хмарного сховища, де будуть розташовані файли Excel.

Додайте залежність Maven у ваш pom.xml (або відповідний фрагмент Gradle):


    com.groupdocs
    groupdocs-merger-cloud
    25.11

Ви можете завантажити останні JAR-файли зі сторінки завантаження. Після додавання залежності створіть об’єкт конфігурації з вашими обліковими даними:

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

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

Коли клієнт готовий, ви можете перейти до фактичного процесу захисту паролем.

Захист Excel паролем через REST у Java: покроковий огляд

Крок 1: Завантажте вихідний документ

Визначте розташування вихідного файлу XLSX у вашому хмарному сховищі.

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

Крок 2: Встановити шлях призначення

Вкажіть, куди буде збережено захищений робочий зошит.

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

Крок 3: Налаштування параметрів захисту паролем

Створіть об’єкт ProtectOptions, прикріпіть інформацію про файл, шлях виводу та бажаний пароль.

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

Крок 4: Створення запиту захисту документа

Обгорніть параметри у ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Крок 5: Виконати запит і обробити відповідь

Викличте метод API та обробіть будь‑які помилки.

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

Для отримання докладної інформації про кожен клас, зверніться до довідка API.

Повний робочий приклад захисту Excel паролем через REST у Java

Наступний код демонструє повний процес від початку до кінця.

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

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили шляхи до файлів (input.xlsx, output_protected.xlsx), щоб вони відповідали фактичним розташуванням ваших файлів, перевірте, що всі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Захист Excel Workbook за допомогою REST API та cURL

Нижче наведено набір команд cURL, які виконують ту ж операцію захисту паролем безпосередньо через REST‑концеві точки.

1. Аутентифікуйтеся та отримайте токен доступу

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

Відповідь містить access_token, який ви будете використовувати у наступних викликах.

2. Завантажте вихідний файл XLSX

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. Запит захисту паролем

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. Завантажте захищений робочий зошит

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

Ці команди дозволяють інтегрувати процес захисту у скрипти або CI‑конвеєри. Для отримання докладнішої інформації перегляньте офіційну документацію API.

Висновок

Впровадження захист паролем Excel через REST у Java є простим за допомогою GroupDocs.Merger Cloud SDK for Java. Дотримуючись наведених вище кроків, ви можете захистити книги Excel, автоматизувати процес у серверних застосунках і зберегти конфіденційні дані в безпеці. Не забудьте отримати відповідну ліцензію для використання у продакшн‑середовищі; інформація про ціни доступна на сторінці продукту, і ви можете розпочати з тимчасової ліцензії, щоб оцінити бібліотеку. Щасливого кодування!

Часті питання

Чим відрізняється захист паролем Excel через REST у Java від локального шифрування?
Хмарний API виконує шифрування на сервері, тому вам не потрібно керувати криптографічними бібліотеками локально. SDK обробляє формування запиту та розбір відповіді, спрощуючи інтеграцію.
Чи можливо встановити додаткові параметри захисту, такі як режим лише для читання?
Поточний клас ProtectOptions зосереджений на захисті паролем. Для більш просунутих функцій безпеки зверніться до довідки API щодо будь‑яких новіших параметрів.
Які формати файлів підтримуються для захисту паролем?
API Merger наразі підтримує XLSX, DOCX, PPTX, та PDF для шифрування. Дивіться офіційну документацію для повного списку.
Чи потрібна мені ліцензія для запуску прикладу у середовищі розробки?
Розробка та тестування можуть виконуватись за допомогою тимчасової ліцензії. Для розгортання у продакшн потрібна платна ліцензія, яку можна придбати на сторінці продукту.