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 注释的最佳实践

验证注释 ID - 始终检查您要删除的 ID 是否存在；尝试删除不存在的 ID 可能会导致 404 错误。
使用 HTTPS - 所有 API 调用必须通过 HTTPS 进行，以保护您的凭据和文档数据。
使用分块上传处理大文件 - 对于大于 100 MB 的 PDF，建议使用多部分上传端点，以避免超时。
记录 API 响应 - 存储请求 ID 和响应，以便审计追踪和更轻松的故障排除。
重用访问令牌 - 缓存 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 端点，在获取注释 ID 后进行删除。完整的工作流程在本指南的代码示例和 cURL 部分中演示。
生产使用需要什么许可证？ 生产环境需要付费许可证。您可以在评估期间从临时许可证页面获取临时许可证。

进一步阅读

在 Node.JS 中通过 REST 编辑 Excel 工作表

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

在构建数据驱动的 Web 服务或报告流水线时，自动化电子表格更新是常见需求。GroupDocs.Editor Cloud SDK for Node.js 只需几行代码即可通过 REST 在 Node.js 中编辑 Excel 文件。在本教程中，您将了解如何配置 SDK、加载一个 XLSX 工作簿、修改一个单元格、保存更改，并使用原始 cURL 调用实现相同的结果。我们还将讨论关键特性、配置选项和性能注意事项，帮助您高效集成 Excel 编辑功能。

在 Node.js via REST 中编辑 Excel 文件 - 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 - 如有需要，用密码保护生成的文件。

调整这些设置以匹配您项目的安全性和性能需求。

编辑 XLSX 工作簿 via REST 的性能考虑

重用配置对象 - 为每个请求创建新的 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 工作表

在 Node.js via REST 中编辑 Excel 文件 - 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 编辑选项

编辑 XLSX 工作簿 via REST 的性能考虑

结论

常见问题

阅读更多