pdf manipulation on Document Processing REST APIs | GroupDocs Cloud

使用 REST 在 Node.JS 中刪除 PDF 的註釋對象

Wed, 21 Oct 2026 13:18:44 +0000

在為分發準備乾淨的文件時，刪除 PDF 中不需要的註釋、標記或墨跡是常見需求。 GroupDocs.Annotation Cloud SDK for Node.js 提供一個功能強大的基於 REST 的庫，讓您能以程式方式管理 PDF 註釋。本指南將逐步說明如何在 Node.JS 中使用 REST 從 PDF 中移除 Annotation 物件。您將看到完整的程式碼範例、等效的 cURL 命令、設定技巧以及最佳實踐建議，以將註釋移除整合到您的服務中。

完整工作範例：使用 REST 在 Node.JS 中移除 PDF 的註釋對象

此範例示範如何上傳 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}`);
})();

注意： 此代碼示例演示了核心功能。在將其用於您的項目之前，請確保更新所有文件路徑和配置值以匹配實際環境，驗證所有必需的依賴項已正確安裝，並在開發環境中徹底測試。如遇到任何問題，請參閱官方文檔或聯繫支援團隊尋求協助。

使用 cURL 透過 REST API 刪除 PDF 註釋

以下是通過 GroupDocs.Annotation Cloud REST 端點執行相同註釋移除工作流程的 cURL 命令。

# 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 文檔。

如何使用 REST 在 Node.JS 中移除 PDF 的註釋對象

身份驗證設定 - Configuration 類別以您的 clientId 和 clientSecret 實例化，為所有後續 API 呼叫建立已驗證的上下文。

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

檔案上傳 - UploadFileRequest 將本機 PDF 位元組傳送至 GroupDocs Cloud 儲存空間。storageApi.uploadFile 方法負責處理傳輸。

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

檢索註釋 - GetAnnotationsRequest 建立包含 FileInfo 參考的請求物件。annotationsApi.getAnnotations 呼叫返回註釋物件集合，從中提取 ID。

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

刪除註釋 - 如果存在任何 ID，則填充 DeleteAnnotationsRequest 並傳遞給 annotationsApi.deleteAnnotations，該方法會永久從已儲存的 PDF 中移除註釋。

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

下載乾淨的 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 包的形式分發。使用下面的命令進行安裝，然後在專案中 require 它。

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 返回的 ID 陣列。提供子集可實現選擇性刪除。

SDK 文件中提供了請求逾時和代理配置等其他設定；請參閱官方文件以獲取完整列表。

使用 REST 刪除 PDF 註釋的最佳實踐

Validate Annotation IDs - 始終檢查您打算刪除的 ID 是否存在；嘗試刪除不存在的 ID 可能會導致 404 錯誤。
Use HTTPS - 所有 API 呼叫必須透過 HTTPS 進行，以保護您的憑證和文件資料。
Handle Large Files with Chunked Uploads - 對於大於 100 MB 的 PDF，建議使用多部份上傳端點，以避免逾時。
Log API Responses - 儲存請求 ID 與回應，以便審計追蹤與更輕鬆的故障排除。
Reuse Access Tokens - 將 OAuth 令牌快取至過期為止，以減少驗證開銷。

常見問題

如何使用 GroupDocs.Annotation Cloud API 進行身份驗證？
從您的 GroupDocs 帳戶獲取客戶端 ID 和密鑰，然後通過 OAuth 端點請求訪問令牌。詳情請參閱官方文檔。
我可以刪除特定的註釋而不是全部嗎？
是的，請在 DeleteAnnotationsRequest 中提供您想要刪除的註釋 ID。SDK 會在執行 GetAnnotations 呼叫後返回註釋 ID 列表。
如何使用 REST 在 Node.JS 中刪除 PDF 的 Annotation 物件？
使用 GroupDocs.Annotation Cloud SDK for Node.js 呼叫 DeleteAnnotations 端點，在取得 annotation ID 後執行。完整工作流程可在本指南的程式碼範例與 cURL 部分中看到。
生產環境使用需要什麼授權？
生產環境需要付費授權。您可以在評估期間從臨時授權頁面獲取臨時授權。

進一步閱讀

在 Node.JS 中合併 PDF

Mon, 19 Oct 2026 15:04:19 +0000

在構建文檔工作流或生成報告時，將多個 PDF 文檔合併為單個文件是一個常見需求。 GroupDocs.Merger Cloud SDK for Node.js 讓在 Node.JS 中合併 PDF 變得簡單，無需處理底層 PDF 結構。本指南將帶您了解設置、逐步實現、完整代碼示例、等效的 cURL 調用以及針對大型或加密 PDF 的性能技巧。

開始之前：先決條件與安裝

在開始之前，請確保您具備以下條件：

Node.js 14 或更高版本已安裝在您的開發機器上。
具有客戶端 ID 和客戶端密鑰的有效 GroupDocs Cloud 帳戶。
訪問您想要合併的 PDF 文件，這些文件存儲在 GroupDocs Cloud 存儲中。

通過 npm 安裝 SDK 並下載最新的套件：

npm install groupdocs-merger-cloud

您也可以從官方發行頁面取得 SDK：Download SDK。安裝完成後，您即可開始編寫程式碼。

在 Node.JS 中合併 PDF 的逐步指南

第一步：安裝 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 文件。此步驟可讓您在 Node.JS 中有效地合併 PDF。

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

這些設定控制您在 Node.JS 中合併 PDF 的方式以及結果將保存的位置。

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

注意： 此代碼示例演示了核心功能。在將其用於您的項目之前，請確保更新所有文件路徑和配置值以匹配實際環境，驗證所有必需的依賴項已正確安裝，並在開發環境中徹底測試。如果遇到任何問題，請參閱官方文檔或聯繫支援團隊尋求協助。

使用 cURL 透過 REST API 合併 PDF

如果您偏好純粹的 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 物件中提供密碼；處理加密文件會增加開銷，盡可能在解密後再進行合併。

應用這些做法可幫助您在 Node.JS 中高效合併 PDF，同時將記憶體消耗降至最低。

您可能有的問題

如何在 Node.JS 中使用 GroupDocs 合併 PDF 檔案？
使用 GroupDocs.Merger Cloud SDK for Node.js 來建立 MergeApi 實例，使用您的來源 PDF 配置 MergeOptions，並呼叫 mergeDocuments。本指南中的完整程式碼範例展示了此過程。
我可以在 Node.JS 中合併加密的 PDF 文件嗎？
是的，SDK 支援合併加密的 PDF。請在呼叫 mergeDocuments 之前，在 FileInfo 物件中提供正確的密碼。詳情請參閱官方文件。
GroupDocs.Merger 的授權選項有哪些？
GroupDocs 提供彈性的定價方案。為了測試，您可以請求一個臨時授權，以在購買完整訂閱之前評估該庫。
我可以在哪裡找到更多範例和支援？
其他範例可在 GitHub repository 上取得。若需協助，請造訪 support forum。

進一步閱讀

在 Java 中為 PDF 文件添加圖像水印

Fri, 28 Aug 2026 19:41:04 +0000

在 PDF 文件中添加視覺識別標誌對於保護知識產權和為文件建立品牌形象至關重要。 GroupDocs.Watermark Cloud SDK for Java 提供簡單的 API，允許直接從 Java 應用程式將圖像水印嵌入 PDF。在本教程中，您將學習如何在 Java 中向 PDF 文檔添加圖像水印，查看完整的工作範例，並探索用於雲端整合的等效 cURL REST 調用。

在 Java 中的 PDF 文件添加圖像水印（5 步）

初始化 API 客戶端：使用您的客戶端 ID 和密鑰建立 ApiClient 實例。

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

此步驟將您的 Java 程式碼連接到 GroupDocs.Watermark Cloud 服務。詳情請參閱 API 參考。

指定來源 PDF 檔案：建立指向您想要加上浮水印的 PDF 的 FileInfo 物件。

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

檔案必須在請求之前上傳至您的 GroupDocs 儲存空間。

配置圖像水印：定義圖像路徑、不透明度、縮放因子、旋轉和對齊方式。

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

調整這些值以實現所需的外觀，不透明度控制透明度，而縮放因子決定相對於頁面的大小。

設定浮水印選項與輸出路徑：將檔案資訊和浮水印結合成 WatermarkOptions 物件。

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

outputPath 告訴服務將產生的 PDF 存放在哪裡。

執行請求：建立 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 文件添加圖像水印

以下示例展示了從客戶端初始化到保存加水印 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）以匹配實際文件位置，驗證所有必需的依賴項已正確安裝，並在開發環境中徹底測試。如遇到任何問題，請參閱官方文檔或聯繫支持團隊尋求幫助。

使用 cURL 和 REST API 為 PDF 文檔添加圖像水印

以下是您可以使用 cURL 的 REST 呼叫，以在不編寫 Java 程式碼的情況下達成相同的結果。

取得存取權杖

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。

上傳來源 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"

上傳水印圖像

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"

新增圖片浮水印

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 程式碼的邏輯，套用相同的透明度、縮放比例和對齊設定。

下載帶有水印的 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。


    com.groupdocs
    groupdocs-watermark-cloud
    23.8

您還需要一個有效的 GroupDocs Cloud 帳戶。從 GroupDocs portal 取得您的 Client ID 和 Client Secret。不需要額外的執行時安裝，因為 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 參考。

結論

在 Java 中為 PDF 文檔添加圖像水印是一項直接的任務，只要使用 GroupDocs.Watermark Cloud SDK for Java。SDK 處理所有低層次的 PDF 操作，讓您專注於不透明度、縮放和定位等視覺方面。無論您偏好本機 Java 實現還是基於雲的 cURL 工作流程，都能在不犧牲性能的情況下實現相同的高品質結果。請記得為生產環境獲取適當的許可證；產品頁面上提供了價格細節，亦可使用臨時許可證頁面進行評估。

常見問題

如何在 Java 中向 PDF 添加圖像水印而不失去品質？
使用 scaleFactor 屬性根據頁面大小調整水印，並保持來源 PDF 的原始 DPI。SDK 會保留 PDF 的解析度，因此水印在任何縮放級別下都保持清晰。
我可以在同一個 PDF 中添加多個水印嗎？
是的。建立具有不同配置的獨立 ImageWatermark 物件，然後透過多次呼叫 addWatermark 依序加入，或將它們加入請求中的清單。
支援的浮水印圖像格式有哪些？
API 接受常見的圖像類型，例如 PNG、JPG、BMP、GIF 和 TIFF。建議使用 PNG 以獲得無損品質和透明度支援。
是否有方法在應用水印之前預覽它？
您可以使用 GroupDocs.Watermark Cloud SDK for Java 生成帶有水印的臨時 PDF，並下載以供審核。這使用相同的 addWatermark 調用，將輸出路徑指向臨時位置。

pdf manipulation on Document Processing REST APIs | GroupDocs Cloud

使用 REST 在 Node.JS 中刪除 PDF 的註釋對象

完整工作範例：使用 REST 在 Node.JS 中移除 PDF 的註釋對象

使用 cURL 透過 REST API 刪除 PDF 註釋

如何使用 REST 在 Node.JS 中移除 PDF 的註釋對象

安裝與設定 GroupDocs.Annotation Cloud SDK for Node.js

註解移除選項與設定

使用 REST 刪除 PDF 註釋的最佳實踐

常見問題

進一步閱讀

在 Node.JS 中合併 PDF

開始之前：先決條件與安裝

在 Node.JS 中合併 PDF 的逐步指南

第一步：安裝 SDK 並匯入所需類別

步驟 2：設定您的 GroupDocs 憑證

第 3 步：定義要合併的 PDF 檔案

步驟 4：設定合併選項

步驟 5：執行合併操作

完整的 PDF 合併實作範例（Node.JS）

使用 cURL 透過 REST API 合併 PDF

配置合併選項

合併 PDF 時的效能考量

您可能有的問題

進一步閱讀

在 Java 中為 PDF 文件添加圖像水印

在 Java 中的 PDF 文件添加圖像水印（5 步）

完整程式碼範例：在 Java 中為 PDF 文件添加圖像水印

使用 cURL 和 REST API 為 PDF 文檔添加圖像水印

安裝與設定 GroupDocs.Watermark Cloud SDK for Java

微調 PDF 文檔的圖像水印選項

調整不透明度

更改比例因子

設定對齊與邊距

結論

常見問題

閱讀更多