Nitro PDF 服務(預覽)

Nitro PDF 服務連接器提供端對端的 PDF 與文件處理:格式間轉換(PDF、Word、Excel、圖片、HTML)、壓縮、合併、分割及編輯檔案(旋轉、刪除頁面、保護/解除保護、扁平化、遮蔽)。 它們也能從 PDF 中擷取結構化資料與洞察——文字、表格、元資料、表單資料及帶有位置的個人識別資訊——同時支援安全的 API 存取與文件屬性管理。

此連接器適用於以下產品和區域:

Service Class 區域
Copilot Studio 進階 除以下部分外,所有Power Automate區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government regions
     - Azure中國地區
     - 美國國防部 (DoD)
Power Apps 進階 除以下部分外,所有Power Apps區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除以下部分外,所有Power Automate區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 氮氣支援
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
類別 生產力;資訊科技營運

Nitro PDF 服務連接器

概觀

Nitro PDF 服務連接器提供端對端的 PDF 與文件處理:格式間轉換(PDF、Word、Excel、圖片、HTML)、壓縮、合併、分割及編輯檔案(旋轉、刪除頁面、保護/解除保護、扁平化、遮蔽)。 它們也能從 PDF 中擷取結構化資料與洞見——文字、表格、元資料、表單資料及帶有位置的個人識別資訊(PII),同時支援安全的 API 存取與文件資產管理。

Publisher: Nitro Software


先決條件

若要使用此連接器使用 Nitro PDF 服務,您需要:


驗證

Nitro PDF 服務使用機器 對機器 OAuth 2.0 搭配 用戶端憑證 授權來產生 API 請求的存取權杖。

運作原理

  • 你在 Nitro 的自助入口網站建立一個 API 應用程式,並取得相關的客戶端 ID客戶端秘密
  • 連接器透過將這些憑證交換為 持有人 存取權杖來進行認證。
  • 該令牌隨後用於授權後續的 Nitro PDF Services API 呼叫。

建立憑證並閱讀詳細指南:
https://developers.gonitro.com/docs/authentication/credentials

在 Power Automate / Power Apps 中建立連線

將連接器加入流程或應用程式時:

  1. 點擊 新增連線
  2. 輸入你的 客戶 ID客戶機密 (在 Nitro 開發者入口網站中發布)。
  3. 儲存連線——首次使用時,連接器會用 OAuth 2.0 用戶端憑證授權,將你的客戶端 ID 和客戶端秘密換成一個短暫的存取權杖,並自動快取並更新。 你的憑證只用來取得該代幣;後續的 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。

輸出格式:
轉換會根據標頭(預設:)Accept回傳 JSON 或二進位輸出application/octet-stream


2. 轉換

修改或重組 PDF 文件的操作。

  • 壓縮 PDF
    利用壓縮等級來縮小檔案大小。

  • 扁平化PDF
    將互動式或分層內容轉換為靜態且不可編輯的元素。 此流程無法復原。

  • 旋轉 PDF 頁面
    使用旋轉陣列(頁面索引 + 角度)旋轉一個或多個頁面。

  • 刪除 PDF 頁面
    依索引移除頁面。

  • 分割 PDF 文件
    根據自訂的頁面範圍,將多頁的 PDF 拆分成多個 PDF。

  • 合併 PDF 文件
    將多個 PDF 合併成一份文件。

  • 編輯 PDF 頁面
    新增遮蔽框以隱藏敏感內容。

  • 設定 PDF 屬性
    更新標準 PDF 元資料欄位。

  • 密碼保護 PDF
    新增密碼保護和存取權限。

  • 解除保護 PDF
    移除密碼和限制。

輸出格式:
轉換可以根據標頭回傳 JSON 或二進位輸出 Accept


3. 抽取

從 PDF 文件中擷取結構化或非結構化資料。

擷取 PDF 表單資料

自動擷取所有表單欄位值。

擷取 PDF 表格資料

識別並回傳 PDF 檔案中的表格資料。

從 PDF 擷取文字

摘錄文字:

  • 來自完整文件,或
  • 透過 pageIndices 參數從特定頁面取得。

額外選填 params 欄位: readingOrder (布林,預設 false)— 當 true,重新排序擷取的文字以符合視覺閱讀流程(對多欄版面很有用)。 輸出品質因文件而異:在標籤良好的 PDF 上效果最佳;在密集的多欄設計中,它可以交錯連接相鄰欄的句子。

從 PDF 中擷取個人識別資訊(PII)位置

找到特定文字值的邊界框。
輸入:字串列表(texts
輸出:包含這些字串的邊界框。

從 PDF 擷取個人資訊

從表單欄位擷取個人識別資訊(PII)邊界框。
支援:

  • English
  • 西班牙文

從 PDF 擷取屬性

擷取 PDF 元資料屬性。

輸出格式:
擷取則只會回傳 JSON


錯誤與節流

Nitro PDF 服務 API 可能會回傳以下錯誤:

  • 400 — 不好的請求
  • 401 — 未經授權
  • 404 — 未找到
  • 413 — 內容過大
  • 422 — 不可處理實體
  • 500 — 內部伺服器錯誤

Throttling

  • 每個連線的 API 呼叫數:每 60 秒100 次。

月台限制

檔案大小

  • 最高: 每個請求 25 MB
    適用於單檔及多檔操作。

頁數

  • 份文件最多250頁
    多份文件的總頁數可能超過250頁。

保留時間

  • 輸入與輸出檔案在操作完成後 ~ 15 分鐘 內被刪除。

Notes

  • 解壓連接器總是回傳 JSON。
  • 轉換與轉換可依標頭輸出 JSON 或二進位 Accept

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有地區 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description Required
Nitro 客戶端識別碼 安全字串 您的 Nitro 應用程式客戶端 ID 沒錯
Nitro 客戶端祕密 安全字串 您的 Nitro 應用程式 客戶端秘密 沒錯

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

Excel 轉 PDF

將 Excel 工作簿轉換成 PDF 文件,同時保留版面與格式。

HTML 轉 PDF

將 HTML 內容或網頁轉換成 PDF 文件。

PDF 轉 Excel

將 PDF 文件轉換成可編輯的 Excel 檔案。

PDF 轉 PowerPoint

將 PDF 文件轉換成可編輯的 PowerPoint 檔案。

PDF 轉 Word

將 PDF 文件轉換成可編輯的 Word 檔案。

PDF轉為圖片

將 PDF 文件的每一頁轉換成圖片檔案。

PowerPoint 轉 PDF

將 PowerPoint 簡報轉換成 PDF 文件。

Word 轉 PDF

將 Word 文件轉換成 PDF 檔案,同時保留格式。

分割 PDF 文件

根據頁數範圍或單頁,將 PDF 文件拆分成多個檔案。

刪除 PDF 頁面

從 PDF 文件中移除一個或多個指定頁面。

合併 PDF 文件

將多個 PDF 文件合併成一個 PDF 檔案。

圖片轉PDF

將一個或多個影像檔案轉換成單一的 PDF 文件。

壓縮 PDF 文件

在保留內容與格式的同時,縮小 PDF 文件的檔案大小。

密碼保護 PDF 文件

在 PDF 文件中加入密碼保護,以限制存取或編輯。

從 PDF 中擷取所有文字

從 PDF 文件中擷取所有可讀文字內容。

從 PDF 擷取個人資訊

從 PDF 文件中偵測並擷取個人識別資訊(PII)。 回傳該 PII 的 PII 值、PII 類別及邊界框位置。 可與 Redaction Block 搭配使用,以遮蔽 PDF。

從 PDF 擷取屬性

可取得文件的元資料與屬性,如標題、作者、建立日期及檔案細節。

從 PDF 擷取搜尋的文字

識別 PDF 文件中可搜尋文字的位置。 回傳每個偵測到的實例的邊界盒位置資料。

從 PDF 文件中移除密碼保護

當提供有效憑證時,請移除 PDF 文件中的密碼保護。

扁平化 PDF 文件

將表單欄位和註解轉換為靜態且不可編輯的內容,將 PDF 扁平化。

擷取 PDF 表單資料

從 PDF 文件中擷取表單欄位資料,並可搭配影像化的 PDF 使用。 回傳鍵值對、標籤及表單資料。

擷取 PDF 表格資料

從 PDF 文件中擷取表格資料。 自動識別檔案中所有資料表,並回傳每個資料表的儲存格、頁首、頁尾及信心分數。

旋轉 PDF 文件

在 PDF 文件中旋轉一個或多個頁面到所需的方向。

編輯 PDF 頁面

永久移除或遮蔽指定內容,顯示部分 PDF 頁面中的內容。

設定 PDF 屬性

更新文件的元資料,如標題、作者、主題或關鍵字。

Excel 轉 PDF

將 Excel 工作簿轉換成 PDF 文件,同時保留版面與格式。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

HTML 轉 PDF

將 HTML 內容或網頁轉換成 PDF 文件。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

PDF 轉 Excel

將 PDF 文件轉換成可編輯的 Excel 檔案。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

PDF 轉 PowerPoint

將 PDF 文件轉換成可編輯的 PowerPoint 檔案。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

PDF 轉 Word

將 PDF 文件轉換成可編輯的 Word 檔案。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

PDF轉為圖片

將 PDF 文件的每一頁轉換成圖片檔案。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

轉換延伸
params string

轉換格式(支援格式 PNG、JPEG)

傳回

名稱 路徑 類型 Description
files
result.files array of object

files

URL
result.files.URL string

URL

內容類型
result.files.contentType string

內容類型

檔案大小位元組
result.files.metadata.fileSizeBytes integer

檔案大小位元組

頁數
result.files.metadata.pageCount string

頁數

檔案內容
$content string

Base64 檔案內容

PowerPoint 轉 PDF

將 PowerPoint 簡報轉換成 PDF 文件。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

Word 轉 PDF

將 Word 文件轉換成 PDF 檔案,同時保留格式。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

分割 PDF 文件

根據頁數範圍或單頁,將 PDF 文件拆分成多個檔案。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

頁面
params True string

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

傳回

名稱 路徑 類型 Description
files
files array of object

files

URL
files.URL string

URL

內容類型
files.contentType string

內容類型

檔案大小位元組
files.metadata.fileSizeBytes integer

檔案大小位元組

頁數
files.metadata.pageCount integer

頁數

檔案內容
$content string

檔案內容

刪除 PDF 頁面

從 PDF 文件中移除一個或多個指定頁面。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

刪除頁面
params True string

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

傳回

名稱 路徑 類型 Description
files
files array of object

files

URL
files.URL string

URL

內容類型
files.contentType string

內容類型

檔案大小位元組
files.metadata.fileSizeBytes integer

檔案大小位元組

頁數
files.metadata.pageCount integer

頁數

檔案內容
$content string

Base64格式的檔案內容

合併 PDF 文件

將多個 PDF 文件合併成一個 PDF 檔案。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案 1
file1 True file

PDF 檔案內容合併 (1)

檔案 2
file2 True file

PDF 檔案內容可合併 (2)

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

圖片轉PDF

將一個或多個影像檔案轉換成單一的 PDF 文件。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

壓縮 PDF 文件

在保留內容與格式的同時,縮小 PDF 文件的檔案大小。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

壓縮等級(0-2)
params True string

格式 {“level”:1}

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

密碼保護 PDF 文件

在 PDF 文件中加入密碼保護,以限制存取或編輯。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

保護參數
params True string

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

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

從 PDF 中擷取所有文字

從 PDF 文件中擷取所有可讀文字內容。

參數

名稱 機碼 必要 類型 Description
檔案內容
file True file

要上傳的檔案

萃取參數
params string

可選的 JSON 物件。 欄位:pageIndices(整數陣列,例如 [0,2];完整文件省略)及 readingOrder(布林值,預設 false;為視覺閱讀流程重新排序文字)。

傳回

名稱 路徑 類型 Description
結果
result string

JSON 結果

從 PDF 擷取個人資訊

從 PDF 文件中偵測並擷取個人識別資訊(PII)。 回傳該 PII 的 PII 值、PII 類別及邊界框位置。 可與 Redaction Block 搭配使用,以遮蔽 PDF。

參數

名稱 機碼 必要 類型 Description
文件語言
params True string

格式 {“language”:“en”}。 公認的數值:「en」(英文)、「es」(西班牙文)。

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
PIIBox
result.PIIBoxes array of object

PIIBox

ID
result.PIIBoxes.ID string

ID

收發簡訊
result.PIIBoxes.text string

收發簡訊

textPiece
result.PIIBoxes.textPiece string

textPiece

頁面索引
result.PIIBoxes.pageIndex integer

頁面索引

邊界框
result.PIIBoxes.boundingBox array of number

邊界框

PIIType
result.PIIBoxes.PIIType string

PIIType

信賴度
result.PIIBoxes.confidence float

信賴度

從 PDF 擷取屬性

可取得文件的元資料與屬性,如標題、作者、建立日期及檔案細節。

參數

名稱 機碼 必要 類型 Description
檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
title
result.title string

title

作者
result.author string

作者

主旨
result.subject string

主旨

關鍵字
result.keywords string

關鍵字

建立者
result.creator string

建立者

製作人
result.producer string

製作人

創建日期
result.creationDate string

創建日期

模組日期
result.modDate string

模組日期

被困住了
result.trapped string

被困住了

從 PDF 擷取搜尋的文字

識別 PDF 文件中可搜尋文字的位置。 回傳每個偵測到的實例的邊界盒位置資料。

參數

名稱 機碼 必要 類型 Description
搜尋關鍵字
params True string

格式 { “texts”: [ “姓名”、“地點” ]}

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
textBoxes
result.textBoxes array of object

textBoxes

ID
result.textBoxes.ID string

ID

收發簡訊
result.textBoxes.text string

收發簡訊

頁面索引
result.textBoxes.pageIndex integer

頁面索引

邊界框
result.textBoxes.boundingBox array of number

邊界框

textPiece
result.textBoxes.textPiece string

textPiece

從 PDF 文件中移除密碼保護

當提供有效憑證時,請移除 PDF 文件中的密碼保護。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

無保護參數
params True string

格式 {“ownerPassword”: “owner-secret”, “userPassword”: “user-secret”}

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

扁平化 PDF 文件

將表單欄位和註解轉換為靜態且不可編輯的內容,將 PDF 扁平化。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

擷取 PDF 表單資料

從 PDF 文件中擷取表單欄位資料,並可搭配影像化的 PDF 使用。 回傳鍵值對、標籤及表單資料。

參數

名稱 機碼 必要 類型 Description
檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
領域
result.fields array of object

領域

欄位名稱
result.fields.name string

表單欄位名稱

欄位值
result.fields.value string

表態欄位值

場信心
result.fields.confidence float

形式場信心

平均信心
result.averageConfidence float

平均信心

擷取 PDF 表格資料

從 PDF 文件中擷取表格資料。 自動識別檔案中所有資料表,並回傳每個資料表的儲存格、頁首、頁尾及信心分數。

參數

名稱 機碼 必要 類型 Description
檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
資料表
result.tables array of object

資料表

ID
result.tables.ID string

ID

pageIndices
result.tables.pageIndices array of integer

pageIndices

title
result.tables.tableData.title string

title

細胞
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
平均信心
result.tables.tableData.averageConfidence float

平均信心

標頭儲存格
result.tables.tableData.headerCells array of array

標頭儲存格

項目
result.tables.tableData.headerCells array of integer
摘要
result.tables.tableData.summaryCells array of array

摘要

項目
result.tables.tableData.summaryCells array of integer

旋轉 PDF 文件

在 PDF 文件中旋轉一個或多個頁面到所需的方向。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

檔案內容
file True file

要上傳的檔案

順時針旋轉頁面
params True string

格式 {“rotations”:[{“page_index”: 0,“amount”: 90}]}

傳回

名稱 路徑 類型 Description
URL
result.file.URL string

URL

內容類型
result.file.contentType string

內容類型

檔案大小位元組
result.file.metadata.fileSizeBytes integer

檔案大小位元組

頁數
result.file.metadata.pageCount integer

頁數

檔案內容
$content string

Base64 檔案內容

編輯 PDF 頁面

永久移除或遮蔽指定內容,顯示部分 PDF 頁面中的內容。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
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

要上傳的檔案

傳回

名稱 路徑 類型 Description
files
files array of object

files

URL
files.URL string

URL

內容類型
files.contentType string

內容類型

檔案大小位元組
files.metadata.fileSizeBytes integer

檔案大小位元組

頁數
files.metadata.pageCount integer

頁數

檔案內容
$content string

Base64 檔案內容

設定 PDF 屬性

更新文件的元資料,如標題、作者、主題或關鍵字。

參數

名稱 機碼 必要 類型 Description
接受(輸出格式)
Accept string

例如 application/json

屬性
params True string

格式 {“title”:「我的文件標題」、「作者」:「John Doe」、「主題」:「一個有趣的主題」、「關鍵字」:「範例、PDF、元資料」、「創作者」:「Doe John」、「producer」:「Nitro PDF」}

檔案內容
file True file

要上傳的檔案

傳回

名稱 路徑 類型 Description
檔案
result.file FileLinkResponse

檔案參考資料

檔案內容
$content string

Base64 檔案內容

定義

FileLink回應

檔案參考資料

名稱 路徑 類型 Description
URL
URL string

URL

檔案大小位元組
metadata.fileSizeBytes integer

檔案大小位元組

頁數
metadata.pageCount integer

頁數