Nitro PDF Services （预览版）

Nitro PDF 服务连接器提供端到端 PDF 和文档处理：在格式之间转换（PDF、Word、Excel、图像、HTML）、压缩、合并、拆分和编辑文件（旋转、删除页面、保护/取消保护、平展、编辑）。 他们还从 PDF（文本、表、元数据、表单数据和具有位置的 PII）中提取结构化数据和见解，同时支持安全的 API 访问和文档属性管理。

此连接器在以下产品和区域中可用：

Service Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系我们
名称 Nitro 支持
URL https://www.gonitro.com/support
Email prosupport@sfdc.gonitro.com
连接器元数据
Publisher Nitro PDF
网站 https://www.gonitro.com/
隐私策略 https://www.gonitro.com/legal/privacy-policy
类别 生产力;IT 操作

Nitro PDF 服务连接器

概述

Nitro PDF 服务连接器提供端到端 PDF 和文档处理：在格式之间转换（PDF、Word、Excel、图像、HTML）、压缩、合并、拆分和编辑文件（旋转、删除页面、保护/取消保护、平展、编辑）。 他们还从 PDF（文本、表、元数据、表单数据和具有位置的 PII）中提取结构化数据和见解，同时支持安全的 API 访问和文档属性管理。

Publisher： Nitro Software

先决条件

若要通过此连接器使用 Nitro PDF 服务，需要：

身份验证

Nitro PDF Services 使用 计算机到计算机 OAuth 2.0 和 客户端凭据 授予来为 API 请求生成访问令牌。

工作原理

  • 在 Nitro 的自助服务门户中创建 API 应用程序，并获取关联的客户端 ID 和客户端密码。
  • 连接器通过交换 持有者 访问令牌的这些凭据进行身份验证。
  • 然后，该令牌用于授权后续的 Nitro PDF 服务 API 调用。

创建凭据并阅读详细指南：
https://developers.gonitro.com/docs/authentication/credentials

在 Power Automate/Power Apps 中创建连接

将连接器添加到流或应用时：

  1. 单击“ 添加新连接”。
  2. 输入 客户端 ID 和 客户端密码 （在 Nitro 开发人员门户中颁发）。
  3. 保存连接 - 首次使用时，连接器使用 OAuth 2.0 客户端凭据授予来交换客户端 ID 和客户端密码，以使用 OAuth 2.0 客户端凭据授予、缓存并自动续订它。 凭据仅用于获取令牌;后续 API 调用是代表你使用持有者令牌进行身份验证的。

注意：无需用户交互式登录;此流专为服务器到服务器/应用到应用方案而设计。

API 主机和基路径

https://api.gonitro.dev

支持的操作

1. 转换

在 PDF 和其他文档格式之间进行转换。

PDF 到 MS Office

  • PDF 到 Word
  • PDF 到 Excel

MS Office 到 PDF

  • Word到 PDF
  • Excel到 PDF
  • PowerPoint到 PDF

图像到 PDF

将通用图像格式（JPG、PNG、TIFF 等）转换为 PDF。

PDF 到图像

将 PDF 页面转换为各种图像格式。

HTML 到 PDF

将 HTML 内容转换为 PDF。

输出格式：
转换根据标头返回 JSON 或二进制输出 Accept （默认值： application/octet-stream） 。

2. 转换

修改或重构 PDF 文档的操作。

  • 压缩 PDF
    使用压缩级别减小文件大小。

  • 平展 PDF
    将交互式内容或分层内容转换为静态不可编辑的元素。 此过程不可逆。

  • 旋转 PDF 页面
    使用旋转数组旋转一个或多个页面（页面索引 + 角度）。

  • 删除 PDF 页面
    按索引删除页面。

  • 拆分 PDF 文档
    根据自定义页面范围将多页 PDF 拆分为多个 PDF。

  • 合并 PDF 文档
    将多个 PDF 合并到单个文档中。

  • Redact PDF 页面
    添加修订框以隐藏敏感内容。

  • 设置 PDF 属性
    更新标准 PDF 元数据字段。

  • 密码保护 PDF
    添加密码保护和访问权限。

  • 取消保护 PDF
    删除密码和限制。

输出格式：
转换可以返回 JSON 或二进制输出， Accept 具体取决于标头。

3. 提取

从 PDF 文档检索结构化或非结构化数据。

提取 PDF 表单数据

自动提取所有窗体字段值。

提取 PDF 表数据

标识和返回 PDF 文件中的表数据。

从 PDF 中提取文本

提取文本：

  • 从完整文档，或
  • 通过参数从 pageIndices 特定页面。

其他可选 params 字段： readingOrder （布尔值，默认值 false） - 何时 true对提取的文本进行重新排序以匹配视觉阅读流（适用于多列布局）。 输出质量因文档而异：最适合标记良好的 PDF;在密集的多列设计上，它可以交错相邻列中的句子。

从 PDF 中提取 PII 位置

查找特定文本值的边界框。
输入：字符串列表 （texts）
输出：包含这些字符串的边界框。

从 PDF 中提取 PII

从窗体字段中提取个人身份信息（PII）边界框。
支持：

  • 英语
  • 西班牙语

从 PDF 中提取属性

提取 PDF 元数据属性。

输出格式：
提取仅返回 JSON 。

错误和限制

Nitro PDF 服务 API 可能会返回以下错误：

  • 400 — 错误的请求
  • 401 - 未授权
  • 404 - 找不到
  • 413 - 内容太大
  • 422 — 无法处理的实体
  • 500 — 内部服务器错误

Throttling

  • 每个连接的 API 调用数：每 60 秒100 次。

平台限制

文件大小

  • 最大值： 每个请求 25 MB
    适用于单文件和多文件操作。

页计数

  • 最大值： 每个文档 250 页
    跨多个文档的总合并页数可能超过 250。

保留时间

  • 操作完成后，输入和输出文件将被删除 约 15 分钟 。

备注

  • 提取连接器始终返回 JSON。
  • 转换和转换可以根据标头输出 JSON 或二进制 Accept 文件。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

名称 类型 说明 必需
Nitro 客户端 ID securestring 你的 Nitro 应用程序客户端 ID 是
Nitro 客户端机密 securestring 你的 Nitro 应用程序客户端密码 是

限制

名称 调用 续订期
每个连接的 API 调用 100 60 秒

操作

Excel到 PDF

将Excel工作簿转换为 PDF 文档，同时保留布局和格式。
HTML 到 PDF

将 HTML 内容或网页转换为 PDF 文档。
PDF 到 Excel

将 PDF 文档转换为可编辑Excel文件。
PDF 到 Word

将 PDF 文档转换为可编辑Word文件。
PDF 到PowerPoint

将 PDF 文档转换为可编辑PowerPoint文件。
PDF 到图像

将 PDF 文档的每一页转换为图像文件。
PowerPoint到 PDF

将PowerPoint演示文稿转换为 PDF 文档。
Redact PDF 页面

永久删除或掩盖所选 PDF 页面中的指定内容。
Word到 PDF

将Word文档转换为 PDF 文件，同时保留格式。
从 PDF 中提取 PII

从 PDF 文档检测和提取个人身份信息（PII）。 返回该 PII 的 PII 值、PII 类别和边界框位置。 可与 Redaction 块结合使用来编辑 PDF。
从 PDF 中提取属性

检索文档元数据和属性，例如标题、作者、创建日期和文件详细信息。
从 PDF 中提取所有文本

从 PDF 文档中提取所有可读文本内容。
从 PDF 中提取搜索的文本

确定 PDF 文档中可搜索文本的位置。 返回每个检测到的实例的边界框位置数据。
从 PDF 文档中删除密码保护

提供有效的凭据时，请从 PDF 文档中删除密码保护。
删除 PDF 页面

从 PDF 文档中删除一个或多个指定页面。
压缩 PDF 文档

减小 PDF 文档的文件大小，同时保留内容和格式。
合并 PDF 文档

将多个 PDF 文档合并到单个 PDF 文件中。
图像到 PDF

将一个或多个图像文件转换为单个 PDF 文档。
密码保护 PDF 文档

将密码保护添加到 PDF 文档以限制访问或编辑。
平展 PDF 文档

通过将表单字段和批注转换为静态不可编辑的内容来平展 PDF。
拆分 PDF 文档

根据页面范围或单个页面将 PDF 文档拆分为多个文件。
提取 PDF 表单数据

从 PDF 文档中提取表单字段数据，可以使用基于图像的 PDF。 返回键值对、窗体中的标签和数据。
提取 PDF 表数据

从 PDF 文档中提取表格数据。 自动标识文件中存在的所有表，并返回每个表的单元格、页眉、页脚和置信度分数。
设置 PDF 属性

更新文档元数据，如标题、作者、主题或关键字。
轮换 PDF 文档

将 PDF 文档中的一个或多个页面旋转为所需方向。

Excel到 PDF

操作 ID:
ExcelToPDF

将Excel工作簿转换为 PDF 文档，同时保留布局和格式。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

HTML 到 PDF

操作 ID:
HTMLToPDF

将 HTML 内容或网页转换为 PDF 文档。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

PDF 到 Excel

操作 ID:
PDFToExcel

将 PDF 文档转换为可编辑Excel文件。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

PDF 到 Word

操作 ID:
PDFToWord

将 PDF 文档转换为可编辑Word文件。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

PDF 到PowerPoint

操作 ID:
PDFToPowerPoint

将 PDF 文档转换为可编辑PowerPoint文件。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

PDF 到图像

操作 ID:
PDFToImage

将 PDF 文档的每一页转换为图像文件。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件
转换扩展
 params string

convert format （supported formats png， jpeg）

返回

名称 路径 类型 说明
files
 result.files array of object

files
URL
 result.files.URL string

URL
内容类型
 result.files.contentType string

内容类型
fileSizeBytes
 result.files.metadata.fileSizeBytes integer

fileSizeBytes
pageCount
 result.files.metadata.pageCount string

pageCount
文件内容
 $content string

Base64 文件内容

PowerPoint到 PDF

操作 ID:
PowerPointToPDF

将PowerPoint演示文稿转换为 PDF 文档。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

Redact PDF 页面

操作 ID:
RedactPDFPages

永久删除或掩盖所选 PDF 页面中的指定内容。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
属性
 params True string

格式 {“redactions”：[{“pageIndex”： 0，“boundingBox”：[100,100,200,120]}，{“pageIndex”： 1，“boundingBox”：[50,50,150,70]}]}
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
files
 files array of object

files
URL
 files.URL string

URL
内容类型
 files.contentType string

内容类型
fileSizeBytes
 files.metadata.fileSizeBytes integer

fileSizeBytes
pageCount
 files.metadata.pageCount integer

pageCount
文件内容
 $content string

Base64 文件内容

Word到 PDF

操作 ID:
WordToPDF

将Word文档转换为 PDF 文件，同时保留格式。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

从 PDF 中提取 PII

操作 ID:
ExtractPIIFromPDF

从 PDF 文档检测和提取个人身份信息（PII）。 返回该 PII 的 PII 值、PII 类别和边界框位置。 可与 Redaction 块结合使用来编辑 PDF。

参数

名称 密钥 必需 类型 说明
文档语言
 params True string

格式 {“language”：“en”}。 接受的值：“en”（英语）、“es”（西班牙语）。
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
PIIBoxes
 result.PIIBoxes array of object

PIIBoxes
ID
 result.PIIBoxes.ID string

ID
文本消息
 result.PIIBoxes.text string

文本消息
textPiece
 result.PIIBoxes.textPiece string

textPiece
pageIndex
 result.PIIBoxes.pageIndex integer

pageIndex
boundingBox
 result.PIIBoxes.boundingBox array of number

boundingBox
PIIType
 result.PIIBoxes.PIIType string

PIIType
可信度
 result.PIIBoxes.confidence float

可信度

从 PDF 中提取属性

操作 ID:
ExtractPropertiesFromPDF

检索文档元数据和属性，例如标题、作者、创建日期和文件详细信息。

参数

名称 密钥 必需 类型 说明
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
标题
 result.title string

标题
作者
 result.author string

作者
主题
 result.subject string

主题
关键字
 result.keywords string

关键字
创建者
 result.creator string

创建者
生产者
 result.producer string

生产者
创建日期
 result.creationDate string

创建日期
modDate
 result.modDate string

modDate
被 困
 result.trapped string

被 困

从 PDF 中提取所有文本

操作 ID:
ExtractTextFromPDF

从 PDF 文档中提取所有可读文本内容。

参数

名称 密钥 必需 类型 说明
文件内容
 file True file

要上传的文件
提取参数
 params string

可选 JSON 对象。 字段：pageIndices（int 数组，例如 [0,2];对于完整文档省略）和 readingOrder（布尔值，默认值 false;重新排序视觉阅读流的文本）。

返回

名称 路径 类型 说明
结果
 result string

JSON 结果

从 PDF 中提取搜索的文本

操作 ID:
ExtractPIILocationFromPDF

确定 PDF 文档中可搜索文本的位置。 返回每个检测到的实例的边界框位置数据。

参数

名称 密钥 必需 类型 说明
要搜索的关键字
 params True string

格式 { “texts”： [ “Name”， “Location” ]}
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
textBoxes
 result.textBoxes array of object

textBoxes
ID
 result.textBoxes.ID string

ID
文本消息
 result.textBoxes.text string

文本消息
pageIndex
 result.textBoxes.pageIndex integer

pageIndex
boundingBox
 result.textBoxes.boundingBox array of number

boundingBox
textPiece
 result.textBoxes.textPiece string

textPiece

从 PDF 文档中删除密码保护

操作 ID:
UnprotectPDFDocument

提供有效的凭据时，请从 PDF 文档中删除密码保护。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件
取消保护参数
 params True string

格式 {“ownerPassword”： “owner-secret”，“userPassword”： “user-secret”}

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

删除 PDF 页面

操作 ID:
DeletePDFPages

从 PDF 文档中删除一个或多个指定页面。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件
删除页面
 params True string

格式 {“pageIndices”：[0,2]}

返回

名称 路径 类型 说明
files
 files array of object

files
URL
 files.URL string

URL
内容类型
 files.contentType string

内容类型
fileSizeBytes
 files.metadata.fileSizeBytes integer

fileSizeBytes
pageCount
 files.metadata.pageCount integer

pageCount
文件内容
 $content string

Base64 格式的文件内容

压缩 PDF 文档

操作 ID:
CompressPDFDocument

减小 PDF 文档的文件大小，同时保留内容和格式。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
压缩级别 （0-2）
 params True string

格式 {“level”：1}
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

合并 PDF 文档

操作 ID:
MergePDFDocuments

将多个 PDF 文档合并到单个 PDF 文件中。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件 1
 file1 True file

要合并的 PDF 文件内容 （1）
文件 2
 file2 True file

要合并的 PDF 文件内容 （2）

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

图像到 PDF

操作 ID:
ImageToPDF

将一个或多个图像文件转换为单个 PDF 文档。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

密码保护 PDF 文档

操作 ID:
PasswordProtectPDFDocument

将密码保护添加到 PDF 文档以限制访问或编辑。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件
保护参数
 params True string

格式 {“ownerPredentials”：“owner-secret”， “userPassword”： “user-secret”， “permissions”： [ “print”， “copy” ] }

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

平展 PDF 文档

操作 ID:
FlattenPDFDocument

通过将表单字段和批注转换为静态不可编辑的内容来平展 PDF。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

拆分 PDF 文档

操作 ID:
SplitPDFDocument

根据页面范围或单个页面将 PDF 文档拆分为多个文件。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件
页数
 params True string

格式 {“pageIndice”：[[0,2]，[1,3,4]]}

返回

名称 路径 类型 说明
files
 files array of object

files
URL
 files.URL string

URL
内容类型
 files.contentType string

内容类型
fileSizeBytes
 files.metadata.fileSizeBytes integer

fileSizeBytes
pageCount
 files.metadata.pageCount integer

pageCount
存档内容
 $content string

存档内容

提取 PDF 表单数据

操作 ID:
ExtractPDFFormData

从 PDF 文档中提取表单字段数据，可以使用基于图像的 PDF。 返回键值对、窗体中的标签和数据。

参数

名称 密钥 必需 类型 说明
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
字段
 result.fields array of object

字段
字段名称
 result.fields.name string

表单字段名称
fieldValue
 result.fields.value string

窗体字段值
fieldConfidence
 result.fields.confidence float

窗体字段置信度
averageConfidence
 result.averageConfidence float

averageConfidence

提取 PDF 表数据

操作 ID:
ExtractPDFTableData

从 PDF 文档中提取表格数据。 自动标识文件中存在的所有表，并返回每个表的单元格、页眉、页脚和置信度分数。

参数

名称 密钥 必需 类型 说明
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
表格
 result.tables array of object

表格
ID
 result.tables.ID string

ID
pageIndices
 result.tables.pageIndices array of integer

pageIndices
标题
 result.tables.tableData.title string

标题
单元格
 result.tables.tableData.cells array of array

单元格
物品
 result.tables.tableData.cells array of string
页脚
 result.tables.tableData.footers array of string

页脚
机密
 result.tables.tableData.confidences array of array

机密
物品
 result.tables.tableData.confidences array of float
averageConfidence
 result.tables.tableData.averageConfidence float

averageConfidence
headerCells
 result.tables.tableData.headerCells array of array

headerCells
物品
 result.tables.tableData.headerCells array of integer
summaryCells
 result.tables.tableData.summaryCells array of array

summaryCells
物品
 result.tables.tableData.summaryCells array of integer

设置 PDF 属性

操作 ID:
SetPDFProperties

更新文档元数据，如标题、作者、主题或关键字。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
属性
 params True string

格式 {“title”：“My Document Title”，“author”： “John Doe”，“subject”： “An Interesting Subject”，“keywords”： “example， pdf， metadata”，“creator”： “Doe John”，“producer”： “Nitro PDF”}
文件内容
 file True file

要上传的文件

返回

名称 路径 类型 说明
文件
 result.file FileLinkResponse

文件引用数据
文件内容
 $content string

Base64 文件内容

轮换 PDF 文档

操作 ID:
RotatePDFDocuments

将 PDF 文档中的一个或多个页面旋转为所需方向。

参数

名称 密钥 必需 类型 说明
接受（输出格式）
 Accept string

例如 application/json
文件内容
 file True file

要上传的文件
旋转页面（顺时针度）
 params True string

格式 {“rotations”：[{“page_index”： 0，“amount”： 90}]}

返回

名称 路径 类型 说明
URL
 result.file.URL string

URL
内容类型
 result.file.contentType string

内容类型
fileSizeBytes
 result.file.metadata.fileSizeBytes integer

fileSizeBytes
pageCount
 result.file.metadata.pageCount integer

pageCount
文件内容
 $content string

Base64 文件内容

定义

FileLinkResponse

文件引用数据

名称 路径 类型 说明
URL
 URL string

URL
fileSizeBytes
 metadata.fileSizeBytes integer

fileSizeBytes
pageCount
 metadata.pageCount integer

pageCount