Повний робочий приклад для видалення об’єктів анотацій з 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. Дивіться офіційну документацію для деталей.

• Чи можу я видалити конкретні анотації замість усіх?
  Так, вкажіть ідентифікатори анотацій, які потрібно видалити, у DeleteAnnotationsRequest. SDK повертає список ідентифікаторів анотацій після виклику GetAnnotations.

• Як можна видалити об’єкти Annotation з PDF за допомогою REST у Node.JS?
  Використовуйте GroupDocs.Annotation Cloud SDK for Node.js для виклику кінцевої точки DeleteAnnotations після отримання ідентифікаторів анотацій. Повний процес продемонстровано у прикладі коду та розділі cURL цього посібника.

• Яка ліцензія потрібна для використання у продакшн?
  Для продакшн потрібна платна ліцензія. Ви можете отримати тимчасову ліцензію на сторінці тимчасової ліцензії під час оцінки.

Подальше читання

• Витягнути або видалити анотації з 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 reference.

Налаштування параметрів злиття

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 з вашим client ID та secret.

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 з водяним знаком доступний у вказаному вами місці.

Повний приклад коду: Додати зображення водяного знака до 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 для 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. Додаткова установка під час виконання не потрібна, оскільки 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, чи хмарному робочому процесу з cURL, можна досягти однакових високоякісних результатів без втрати продуктивності. Пам’ятайте, що для використання у продакшн‑середовищі необхідно отримати відповідну ліцензію; деталі ціноутворення доступні на сторінці продукту, а сторінка тимчасової ліцензії можна використати для оцінки.

FAQs

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