Полный рабочий пример удаления объектов аннотаций из PDF с помощью REST в Node.JS

В этом примере демонстрируется, как загрузить PDF, удалить все его аннотации и скачать очищенный файл с использованием 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}`);
})();

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Удалить аннотации PDF через REST API с помощью cURL

Ниже приведены команды cURL, которые выполняют тот же процесс удаления аннотаций через REST‑конечные точки 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

Для полного списка конечных точек и параметров см. официальную документацию API.

Как удалить объекты аннотаций из PDF с помощью REST в Node.JS

1. Настройка аутентификации – Класс Configuration создаётся с вашими clientId и clientSecret, создавая аутентифицированный контекст для всех последующих вызовов API.

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

2. Загрузка файла – UploadFileRequest отправляет локальные байты PDF в хранилище GroupDocs Cloud. Метод storageApi.uploadFile обрабатывает передачу.

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

3. Получение аннотаций – GetAnnotationsRequest формирует объект запроса с ссылкой на FileInfo. Вызов annotationsApi.getAnnotations возвращает коллекцию объектов аннотаций, из которой извлекаются идентификаторы.

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

4. Удаление аннотаций – Если существуют идентификаторы, DeleteAnnotationsRequest заполняется и передаётся в annotationsApi.deleteAnnotations, который навсегда удаляет аннотации из сохранённого PDF.

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

5. Скачивание очищенного PDF – Наконец, DownloadFileRequest получает обновлённый файл, а fs.writeFileSync записывает его в локальную файловую систему.

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

Для получения подробных определений классов и методов обратитесь к Справке API.

Установка и настройка GroupDocs.Annotation Cloud SDK for Node.js

SDK распространяется как npm‑пакет. Установите его с помощью команды ниже, а затем подключите в вашем проекте.

npm install groupdocs-annotation-cloud

Вы также можете загрузить последнюю версию пакета напрямую со страницы страница релизов GitHub или с официального URL загрузки.

После установки импортируйте библиотеку и создайте объект конфигурации, как показано в примере кода:

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

Убедитесь, что ваша среда выполнения соответствует требованиям к версии Node.js и у вас есть действующий аккаунт GroupDocs для получения клиентских учетных данных.

Параметры и настройки удаления аннотаций

SDK предоставляет несколько параметров, которые вы можете настроить:

• clientId / clientSecret - Учётные данные для аутентификации OAuth. Установите их в конструкторе Configuration.
• fileInfo.filePath - Путь к PDF в хранилище GroupDocs Cloud. При необходимости измените его, если файлы находятся в другой папке.
• annotationIds - Массив идентификаторов, возвращаемый GetAnnotations. Предоставление подмножества позволяет выполнять выборочное удаление.

Дополнительные настройки, такие как тайм‑ауты запросов и конфигурация прокси, доступны в документации SDK; см. официальную документацию для полного списка.

Лучшие практики удаления аннотаций PDF через REST

• Проверка идентификаторов аннотаций - Всегда проверяйте, что идентификаторы, которые вы собираетесь удалить, существуют; попытка удалить несуществующие идентификаторы может вызвать ошибку 404.
• Использовать HTTPS - Все вызовы API должны выполняться через HTTPS для защиты ваших учетных данных и данных документов.
• Обрабатывать большие файлы с помощью загрузки кусками - Для PDF-файлов размером более 100 МБ предпочтительно использовать конечную точку multipart‑загрузки, чтобы избежать тайм‑аутов.
• Записывать ответы API - Сохраняйте идентификаторы запросов и ответы для аудита и упрощения устранения неполадок.
• Повторное использование токенов доступа - Кешируйте OAuth‑токен до его истечения, чтобы снизить нагрузку на аутентификацию.

Общие вопросы

• Как аутентифицироваться с GroupDocs.Annotation Cloud API?
  Получите client ID и secret из вашей учетной записи GroupDocs, затем запросите access token через OAuth endpoint. См. official documentation для подробностей.

• Могу ли я удалить конкретные аннотации вместо всех?
  Да, укажите идентификаторы аннотаций, которые хотите удалить, в DeleteAnnotationsRequest. SDK возвращает список идентификаторов аннотаций после вызова GetAnnotations.

• Как удалить объекты Annotation из PDF с помощью REST в Node.JS?
  Используйте GroupDocs.Annotation Cloud SDK для Node.js, чтобы вызвать endpoint DeleteAnnotations после получения идентификаторов аннотаций. Полный процесс продемонстрирован в примере кода и разделе cURL этого руководства.

• Какова лицензия, необходима для использования в продакшене?
  Для продакшена требуется платная лицензия. Вы можете получить временную лицензию на странице temporary license page во время оценки.

Дополнительное чтение

• Извлечение или удаление аннотаций из PDF с помощью REST API в Node.js
• Зачёркнутый текст в PDF с Node.js и REST API
• Удаление аннотаций из PDF с помощью REST API в Python

Перед началом: Требования и установка

Прежде чем начать, убедитесь, что у вас есть следующее:

• Node.js 14 или более поздней версии, установленный на вашей машине разработки.
• Активный аккаунт GroupDocs Cloud с client ID и client secret.
• Доступ к PDF‑файлам, которые вы хотите объединить, хранящимся в хранилище GroupDocs Cloud.

Установите SDK через npm и загрузите последнюю версию пакета:

npm install groupdocs-merger-cloud

Вы также можете получить SDK со страницы официального релиза: Скачать SDK. После установки вы готовы приступить к написанию кода.

Пошаговое руководство по объединению PDF в Node.JS

Шаг 1: Установите SDK и импортируйте необходимые классы

Сначала импортируйте классы, которые вам понадобятся для объединения PDF‑файлов.

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

Этот импорт предоставляет вам доступ к основному API, объектам конфигурации и дескрипторам файлов.

Шаг 2: Настройте свои учетные данные GroupDocs

Создайте объект конфигурации с вашими учетными данными клиента.

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

Предоставление правильных учетных данных позволяет библиотеке аутентифицировать ваши запросы.

Шаг 3: Определите PDF‑файлы для объединения

Список PDF‑документов, которые вы хотите объединить. Этот шаг готовит вас к эффективному объединению PDF в Node.JS.

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

Каждый FileInfo указывает на файл, хранящийся в вашем хранилище GroupDocs Cloud.

Шаг 4: Установить параметры слияния

Настройте место вывода и прикрепите список файлов к запросу на слияние.

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

Эти настройки контролируют, как вы объединяете PDF в Node.JS и где будет сохранён результат.

Шаг 5: Выполнить операцию слияния

Создайте экземпляр API, вызовите метод merge и обработайте ответ.

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

Асинхронный вызов возвращает путь к объединённому документу, если операция выполнена успешно.

Полный пример реализации объединения PDF в Node.JS

Следующий код демонстрирует полный рабочий процесс от конфигурации до обработки результата.

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

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Объединение PDF через REST API с использованием cURL

Если вы предпочитаете чисто REST‑подход, ту же операцию можно выполнить с помощью команд cURL.

Сначала получите токен доступа:

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

Загрузите исходные PDF‑файлы в ваше хранилище (замените YOUR_ACCESS_TOKEN токеном из предыдущего шага):

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"

Повторите загрузку для input2.pdf. Затем запросите операцию слияния:

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

Наконец, загрузите объединённый файл:

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

Для полного списка конечных точек и параметров см. справку API.

Настройка параметров объединения

SDK предоставляет несколько параметров, позволяющих точно настроить процесс слияния:

• outputPath - Путь назначения для объединённого PDF. Настройте его, чтобы контролировать, где будет сохранён результат.
• fileInfos - Массив объектов FileInfo, определяющих исходные PDF и их порядок.

Вы также можете задать дополнительные свойства, такие как pages для объединения определённых диапазонов страниц или password для зашифрованных PDF. Обратитесь к официальной документации для полного списка настраиваемых полей.

Соображения по производительности при объединении PDF

При объединении больших или множества PDF‑файлов учитывайте следующие рекомендации:

• Используйте async/await, чтобы избежать блокировки цикла событий, особенно для больших документов.
• Пакетные загрузки: загружайте исходные PDF‑файлы параллельно перед вызовом слияния, чтобы снизить общую задержку.
• Потоковая обработка: для чрезвычайно больших PDF рассмотрите возможность хранения промежуточных результатов в облачном хранилище и слияния их небольшими частями.
• Зашифрованные PDF: указывайте пароли в объектах FileInfo; обработка зашифрованных файлов добавляет накладные расходы, поэтому по возможности сливайте их после расшифровки.

Применение этих практик помогает эффективно объединять PDF в Node.JS, минимизируя потребление памяти.

Вопросы, которые могут у вас возникнуть

• Как объединить PDF‑файлы в Node.JS с помощью GroupDocs?
  Используйте GroupDocs.Merger Cloud SDK for Node.js для создания экземпляра MergeApi, настройки MergeOptions с вашими исходными PDF и вызова mergeDocuments. Полный пример кода в этом руководстве демонстрирует процесс.

• Могу ли я объединять зашифрованные PDF-файлы в Node.JS?
  Да, SDK поддерживает объединение зашифрованных PDF. Укажите правильные пароли в объектах FileInfo перед вызовом mergeDocuments. См. официальную документацию для получения подробностей.

• Какие варианты лицензирования доступны для GroupDocs.Merger?
  GroupDocs предлагает гибкие тарифные планы. Для тестирования вы можете запросить временную лицензию, чтобы оценить библиотеку перед покупкой полной подписки.

• Где я могу найти больше примеров и поддержку?
  Дополнительные образцы доступны в репозитории GitHub. Для получения помощи посетите форум поддержки.

Дополнительное чтение

• Разделить PDF на несколько PDF в Node.JS
• Заблокировать PDF-документы паролями с помощью REST API в Node.js
• Как объединить PDF-файлы в C# с использованием REST API

Добавьте изображение водяного знака в PDF‑документы на Java за 5 шагов

1. Инициализировать клиент API: Создайте экземпляр ApiClient с вашим идентификатором клиента и секретом.

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

Этот шаг подключает ваш Java‑код к сервису GroupDocs.Watermark Cloud. См. API reference для получения дополнительных сведений.

2. Укажите исходный PDF‑файл: Создайте объект FileInfo, указывающий на PDF, который вы хотите пометить водяным знаком.

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

Файл должен быть загружен в ваше хранилище GroupDocs перед запросом.

3. Настройте водяной знак изображения: определите путь к изображению, непрозрачность, коэффициент масштабирования, вращение и выравнивание.

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

Отрегулируйте эти значения, чтобы достичь желаемого внешнего вида: непрозрачность управляет прозрачностью, а scaleFactor определяет размер относительно страницы.

4. Установите параметры водяного знака и путь вывода: Объедините информацию о файле и водяной знак в объект WatermarkOptions.

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

   outputPath указывает сервису, где хранить полученный PDF.

5. Выполнить запрос: Создайте AddWatermarkRequest и вызовите 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());
}

После выполнения водяной знак будет доступен в указанном вами месте.

Полный пример кода: Добавление графического водяного знака в PDF‑документы на Java

Следующий пример демонстрирует полную реализацию от инициализации клиента до сохранения PDF с водяным знаком.

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

Примечание: Этот пример кода демонстрирует базовый функционал. Прежде чем использовать его в вашем проекте, убедитесь, что обновили пути к файлам (input.pdf, watermark.png, output.pdf) в соответствии с вашими реальными расположениями, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с службой поддержки для получения помощи.

Применить графический водяной знак к PDF‑документам с помощью cURL и REST API

Ниже приведены REST‑запросы, которые вы можете использовать с cURL, чтобы достичь того же результата без написания кода на Java.

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. Загрузить исходный PDF

   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. Загрузите изображение водяного знака

   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. Добавить водяной знак изображения

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

   Этот запрос повторяет логику Java‑кода, применяя те же настройки непрозрачности, масштабирования и выравнивания.

5. Скачать PDF с водяным знаком

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

Для получения более подробной информации о телах запросов и поддерживаемых параметрах см. официальную документацию API.

Установка и настройка GroupDocs.Watermark Cloud SDK for Java

Добавьте зависимость Maven в ваш pom.xml (или эквивалентный фрагмент Gradle). Библиотека размещена в Maven Central.

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

Вам также нужен действительный аккаунт GroupDocs Cloud. Получите ваш Client ID и Client Secret из GroupDocs portal. Дополнительная установка среды выполнения не требуется, поскольку SDK взаимодействует с облачным сервисом.

Тонкая настройка параметров водяного знака изображения для PDF-документов

SDK предоставляет несколько свойств, позволяющих контролировать визуальный вид водяного знака.

Настройка непрозрачности

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

Значения непрозрачности варьируются от 0.0 (полностью прозрачный) до 1.0 (полностью непрозрачный).

Изменить коэффициент масштабирования

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

Коэффициент масштабирования определяет размер водяного знака относительно размеров страницы.

Установить выравнивание и отступы

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

Эти настройки размещают водяной знак в правом нижнем углу с отступом 20 пунктов.

Для полного списка настраиваемых свойств обратитесь к справке API.

Заключение

Добавление водяного знака‑изображения в PDF‑документы на Java — простая задача, когда вы используете GroupDocs.Watermark Cloud SDK for Java. SDK обрабатывает все низкоуровневые операции с PDF, позволяя сосредоточиться на визуальных аспектах, таких как непрозрачность, масштабирование и позиционирование. Независимо от того, предпочитаете ли вы нативную реализацию на Java или облачный workflow cURL, можно достичь тех же высококачественных результатов без потери производительности. Не забудьте получить соответствующую лицензию для использования в продакшене; детали ценообразования доступны на странице продукта, а страница временной лицензии можно использовать для оценки.

Часто задаваемые вопросы

• Как добавить водяной знак изображения в PDF на Java без потери качества?
  Используйте свойство scaleFactor, чтобы задать размер водяного знака относительно страницы и сохранить оригинальное DPI исходного PDF. SDK сохраняет разрешение PDF, поэтому водяной знак выглядит чётко при любом уровне масштабирования.

• Могу ли я добавить несколько водяных знаков в один и тот же PDF?
  Да. Создайте отдельные объекты ImageWatermark с разными конфигурациями и добавляйте их последовательно, вызывая addWatermark несколько раз, или добавьте их в список в запросе.

• Какие форматы изображений поддерживаются для водяного знака?
  API принимает распространённые типы изображений, такие как PNG, JPG, BMP, GIF и TIFF. Рекомендуется использовать PNG для качества без потерь и поддержки прозрачности.

• Есть ли способ предварительно просмотреть водяной знак перед его применением?
  Вы можете использовать GroupDocs.Watermark Cloud SDK for Java для создания временного PDF с водяным знаком и загрузить его для проверки. Это использует тот же вызов addWatermark с указанием пути вывода, указывающего на временное расположение.

Подробнее

• Добавить водяной знак к изображениям с помощью Java
• Добавить водяной знак в Word на Java - Watermark Creator
• Добавить изображение водяного знака в PDF | Как добавить водяной знак в PDF‑документы с помощью .NET