适用于任何平台的文档和图像注释解决方案。

GroupDocs.Annotation Cloud API 是一个独立于平台的文档和图像注释解决方案，使开发人员能够以最少的努力在其应用程序中添加注释功能。该 API 支持一系列注释类型，但在这篇文章中，我将重点关注文本密文注释，以演示如何密文 PDF 文本。

文本编辑是从文档中永久删除内容的过程。在发布文档之前，您需要从文档中删除敏感和私人数据。 GroupDocs.Annotation Cloud 提供文本编辑注释来编辑特定页面区域上的文本。文本密文用黑色矩形填充部分文本，以隐藏底层单词或短语。

让我快速概述一下如何使用 GroupDocs.Annotation Cloud 通过一组简单的 HTTP 请求来编辑文本。在此示例中，我将使用 cURL 来编辑 PDF 文档中的文本。该API不限于PDF文件格式，您可以查看支持的文件格式的完整列表。它还提供适用于所有流行编程语言的 SDK。您可以通过工作示例检查可用的来自 GitHub 存储库的 SDK，并直接在您的应用程序中使用。

我们将按照以下步骤查找重复图像：

  • 生成用于身份验证的访问令牌
  • 将源文档上传至存储
  • 向文档添加注释
  • 下载带注释的文档

生成访问令牌

### Retrieve access token JWT(JSON Web Token)
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl --request POST https://api.groupdocs.cloud/connect/token 
--header "Content-Type: application/x-www-form-urlencoded" 
--data "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"

将源文档上传至存储

### Upload document to default storage
curl -X POST "https://api.groupdocs.cloud/v2.0/annotation/storage/file/02_pages.pdf" 
-H "accept: application/json" 
-H "authorization: Bearer [Access_Token]" 
-H "Content-Type: multipart/form-data" 
-F "File=@C:/Temp/02_pages.pdf"

注释源文档

SvgPath 属性用于添加文本密文注释，SvgPath 属性的坐标从文档页面的底部开始逐渐增加到顶部。

### Add annotation to source document
curl -X POST "https://api.groupdocs.cloud/v2.0/annotation?filePath=02_pages.pdf" 
-H "accept: application/json" 
-H "authorization: Bearer [Access_Token]" 
-H "Content-Type: application/json" 
-d "[
  {
    "guid": null,
    "documentGuid": 0,
    "text": null,
    "creatorGuid": null,
    "creatorName": "Anonym A.",
    "creatorEmail": null,
 "svgPath":"[{'x':55.2986,'y':613.5769},{'x':260.7985,'y':613.5769},{'x':55.2986,'y':600.5769},{'x':260.7985,'y':600.5769}]",
    "type": 9,
    "access": null,
    "replies": null,
    "createdOn": "0001-01-01T00:00:00",
    "fontColor": null,
    "penColor": 1201033,
    "penWidth": 1,
    "penStyle": 0,
    "backgroundColor": null,
    "fieldText": null,
    "fontFamily": null,
    "fontSize": null,
    "opacity": null,
    "angle": null
  }
]"

下载带注释的文档

### Download annotated document
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/result?filePath=02_pages.pdf&annotatedPages=false&firstPage=-1&lastPage=-1" 
-H "accept: application/json" 
-H "authorization: Bearer [Access_Token]" 
--output C:/Temp/02_pages_output.pdf

如果您还没有尝试过我们的 REST API，我们鼓励您立即前往 GroupDocs.Annotation Cloud 进行免费试用。您所需要的只是注册 groupdocs.cloud。注册后，您可以浏览 GroupDocs.Annotation Cloud 的以下有用资源。

反馈

您的反馈对我们非常重要。如果您有任何建议或者需要任何您期望我们的 REST API 具有的特定功能，请随时在下面或在 支持论坛 中给我们留言。