nodejs rest api 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 中通過 REST 編輯 Excel 工作表

Fri, 02 Oct 2026 14:32:02 +0000

自動化試算表更新是在構建資料驅動的 Web 服務或報告管道時的常見需求。 GroupDocs.Editor Cloud SDK for Node.js 讓您只需幾行程式碼即可在 Node.js 中透過 REST 編輯 Excel 檔案。在本教學中，您將看到如何設定 SDK、載入 XLSX 工作簿、修改儲存格、儲存變更，並使用原始 cURL 呼叫達成相同結果。我們還將討論關鍵功能、設定選項和效能考量，協助您有效整合 Excel 編輯功能。

編輯 Excel 檔案於 Node.js 透過 REST - 5 步驟指南

安裝 SDK 並配置憑證: 設定您的 CLIENT_ID 和 CLIENT_SECRET，以便庫能夠與 GroupDocs Cloud 進行身份驗證。

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
const editApi = new GroupDocsEditorCloud.EditApi(config);

載入 Excel 工作簿以進行編輯：使用 EditDocumentRequest 開啟儲存在雲端儲存中的檔案。

const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
    fileInfo: new GroupDocsEditorCloud.FileInfo({ filePath: "input.xlsx" })
});
const editResult = await editApi.editDocument(editRequest);

檢索第一個工作表並定位目標儲存格：SDK 會返回一個包含工作表和儲存格的 document 物件。

const worksheet = editResult.document.worksheets[0];
let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);

更新或建立儲存格值：變更儲存格 A1 的內容（如果不存在則新增）。

if (!targetCell) {
    targetCell = new GroupDocsEditorCloud.Cell({
        rowIndex: 0,
        columnIndex: 0,
        value: "Edited via GroupDocs Editor Cloud"
    });
    worksheet.cells.push(targetCell);
} else {
    targetCell.value = "Edited via GroupDocs Editor Cloud";
}

將編輯過的工作簿儲存回儲存空間：提供 outputPath 並呼叫 saveDocument。

const saveOptions = new GroupDocsEditorCloud.SaveOptions({ outputPath: "output.xlsx" });
const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
    documentId: editResult.documentId,
    document: editResult.document,
    saveOptions: saveOptions
});
await editApi.saveDocument(saveRequest);

欲查看完整的類別與方法清單，請參閱 API 參考。

在 Node.js 中透過 REST 編輯 Excel 檔案 - 完整程式碼範例

以下範例示範如何在 Node.js 中透過 REST 使用 GroupDocs.Editor Cloud SDK 編輯 Excel 檔案。

const GroupDocsEditorCloud = require("@groupdocs/editor-cloud");

// Replace with your actual GroupDocs Cloud credentials
const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Paths for the source Excel file and the edited result
const INPUT_FILE_PATH = "input.xlsx";
const OUTPUT_FILE_PATH = "output.xlsx";

async function editExcel() {
    // Configure the SDK
    const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
    const editApi = new GroupDocsEditorCloud.EditApi(config);

// 1. Load the Excel workbook for editing
    const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
        fileInfo: new GroupDocsEditorCloud.FileInfo({
            filePath: INPUT_FILE_PATH
        })
    });

const editResult = await editApi.editDocument(editRequest);
    const documentId = editResult.documentId;
    const document = editResult.document;

// 2. Retrieve the first worksheet
    const worksheet = document.worksheets[0];

// 3. Update cell A1 (rowIndex = 0, columnIndex = 0) with a new value
    let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);
    if (!targetCell) {
        targetCell = new GroupDocsEditorCloud.Cell({
            rowIndex: 0,
            columnIndex: 0,
            value: "Edited via GroupDocs Editor Cloud"
        });
        worksheet.cells.push(targetCell);
    } else {
        targetCell.value = "Edited via GroupDocs Editor Cloud";
    }

// 4. Save the edited workbook back to storage
    const saveOptions = new GroupDocsEditorCloud.SaveOptions({
        outputPath: OUTPUT_FILE_PATH
    });

const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
        documentId: documentId,
        document: document,
        saveOptions: saveOptions
    });

const saveResult = await editApi.saveDocument(saveRequest);
    console.log(`Edited file saved to: ${saveResult.path}`);
}

// Execute the edit operation
editExcel().catch(error => {
    console.error("Error during Excel editing:", error);
});

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

使用 REST API 在 Node.js 中透過 cURL 更新 XLSX 工作表

以下是一個使用原始 HTTP 呼叫執行相同操作的快速步驟說明。請將佔位符值替換為您的實際憑證和檔案名稱。

取得存取權杖

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

回應中包含 access_token。

上傳來源 XLSX 檔案

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.xlsx"

編輯工作簿（修改 A1 單元格）

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "options": {
               "cells": [
                   { "rowIndex": 0, "columnIndex": 0, "value": "Edited via GroupDocs Editor Cloud" }
               ]
           }
         }'

下載已編輯的檔案

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

如需了解有關請求有效負載的更多詳細資訊，請參閱官方 API 文檔。

GroupDocs.Editor Cloud SDK for Node.js 的先決條件與設定

要開始使用 SDK，您需要 Node.js 14 或更高版本，以及一個 GroupDocs Cloud 帳戶。

npm install groupdocs-editor-cloud

您也可以從發行頁面下載最新的套件。安裝完成後，請在您的 GroupDocs Cloud 儀表板中建立 client_id 和 client_secret，並妥善保存它們。

什麼使 GroupDocs.Editor Cloud SDK for Node.js 成為修改 Excel 工作表的理想選擇

完整的 XLSX 支援 - 載入、編輯並儲存活頁簿，同時保留公式、樣式和資料驗證。
儲存格層級編輯 - 以程式方式存取單一儲存格、列或欄，這對於更新報告或儀表板非常適合。
雲端儲存整合 - 直接操作存放於 GroupDocs Cloud 的檔案，無需下載到本機。
安全的 REST 通訊 - 所有操作皆透過 HTTPS 進行，SDK 會為您處理令牌管理。

如需更深入了解，請參閱文檔。

微調 GroupDocs.Editor Cloud 中的 Excel 編輯選項

SDK 提供了多種選項，讓您可以控制已編輯工作簿的保存方式。

const saveOptions = new GroupDocsEditorCloud.SaveOptions({
    outputPath: "output.xlsx",
    // You can also set compression level, password protection, etc.
});

outputPath - 雲端儲存中的目標路徑。
compressionLevel - 減少大型工作簿的檔案大小（可在 API 參考中找到）。
password - 如有需要，使用密碼保護產生的檔案。

調整這些設定以符合您專案的安全性和效能需求。

透過 REST 編輯 XLSX 工作簿的效能考量

重用配置物件 - 為每個請求建立新的 Configuration 會增加額外負擔。請在應用程式的整個生命週期內保持單一實例。
批次儲存格更新 - 如果需要修改大量儲存格，請將它們收集到陣列中，並發送單一的編輯請求，而非多次呼叫。
限制工作表大小 - 非常大的工作表會增加記憶體消耗。盡可能將資料分割到多個工作表中。
避免不必要的儲存 - 僅在所有必要變更完成後才呼叫 saveDocument，以減少 I/O 操作。

結論

在 Node.js 中透過 REST 編輯 Excel 檔案變得簡單，只需使用 GroupDocs.Editor Cloud SDK for Node.js。您可以以程式方式載入工作簿、修改儲存格，並僅透過少量 API 呼叫或簡單的 cURL 指令即可儲存結果。SDK 的雲端架構消除對本機 Office 安裝的需求，並能隨您的應用程式工作負載擴展。對於正式環境部署，請購買符合使用模式的授權，您亦可從臨時授權頁面取得測試用的臨時授權。立即開始整合 Excel 編輯，簡化您的資料處理流程。

常見問題

如何在 Node.js 中透過 REST 編輯 Excel 檔案而不撰寫自訂 HTTP 程式碼？
使用 GroupDocs.Editor Cloud SDK for Node.js，它抽象化了 REST 呼叫，讓您只需簡單的方法呼叫即可在 Node.js 中透過 REST 編輯 Excel 檔案。

我可以使用 REST api Node.js 更新大型 XLSX 工作表嗎？
是的。SDK 會串流資料並支援批次更新，使其適用於大型活頁簿。調整 compressionLevel 和批次儲存格變更以提升效能。

什麼是以 Node.js 程式方式修改 Excel 工作表的最佳方法？
使用 editDocument 回傳的 worksheet 和 cell 物件。這讓您在不離開 Node.js 環境的情況下，完整控制列、欄和儲存格值。

我可以在哪裡找到價格和授權資訊？
所有授權細節，包括價格層級和用於評估的臨時授權，都可在臨時授權頁面上取得。

nodejs rest api 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 中通過 REST 編輯 Excel 工作表

編輯 Excel 檔案於 Node.js 透過 REST - 5 步驟指南

在 Node.js 中透過 REST 編輯 Excel 檔案 - 完整程式碼範例

使用 REST API 在 Node.js 中透過 cURL 更新 XLSX 工作表

GroupDocs.Editor Cloud SDK for Node.js 的先決條件與設定

什麼使 GroupDocs.Editor Cloud SDK for Node.js 成為修改 Excel 工作表的理想選擇

微調 GroupDocs.Editor Cloud 中的 Excel 編輯選項

透過 REST 編輯 XLSX 工作簿的效能考量

結論

常見問題

閱讀更多