DocuSign API：列出所有尚未簽署信封的收件人

導航 DocuSign API 以管理信封

在數碼協議快速發展的世界中，企業依賴電子簽名平台來簡化工作流程。DocuSign 作為該領域的領導者，提供強大的 API 功能，允許開發者自動化和監控文件流程。一個常見挑戰是追蹤信封中收件人的狀態——特別是識別尚未簽名的收件人。此功能對於合規性、跟進和營運效率至關重要，尤其是在高容量環境中，如銷售團隊或法律部門。

理解 DocuSign API 和信封收件人

DocuSign 的 eSignature API 提供端點來管理信封，這些信封本質上是需要簽名的文件容器。一個信封可以有多個收件人，每個收件人具有如簽名者、審批者或抄送者的角色。API 使用 RESTful 架構，支持 JSON 負載，並需要透過 OAuth 2.0 或 JWT 授權進行身份驗證。

要列出尚未簽署信封的所有收件人，開發者通常查詢信封的狀態和收件人詳細信息。關鍵端點是 Envelopes API 中的 GET /accounts/{accountId}/envelopes/{envelopeId}/recipients。這將返回收件人的全面列表，包括他們的狀態（例如，“sent”、“declined”、“signed” 或 “needs_to_sign”）。

以下是實現此功能的逐步指南：

1. 身份驗證設置：使用 DocuSign 的開發者沙箱獲取訪問令牌。對於生產環境，與您的應用的 IAM（身份和訪問管理）系統集成。DocuSign 的 IAM 功能是其增強計劃的一部分，包括與 Okta 或 Azure AD 等提供商的 SSO 集成，確保安全的 API 訪問，而無需暴露憑證。

2. 檢索信封詳細信息：首先，使用 GET /envelopes/{envelopeId} 獲取信封。這將確認信封狀態（例如，“sent” 或 “in_progress”）並提供元數據，如創建日期和截止日期。

3. 查詢收件人：調用收件人端點。響應包括收件人對象的陣列，每個對象包含：

   • id：唯一標識符。
   • email：收件人的電子郵件。
   • status：當前狀態（過濾 “sent” 或 “needs_to_sign” 以識別未簽名的收件人）。
   • routingOrder：簽名流程中的順序。
   • name：收件人的姓名。

   API 響應中的示例 JSON 片段：

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. 過濾未簽名收件人：在您的代碼中（例如，使用 requests 庫的 Python 或使用 Axios 的 Node.js），解析響應並過濾 status != “signed” 且 signedDateTime 為 null 的情況。對於批量操作，使用帶有查詢參數如 status=sent 的 GET /envelopes 端點來列出多個信封。

   示例 Python 代碼：

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. 錯誤處理和最佳實踐：處理速率限制（例如，每分鐘 1000 次 API 調用）和錯誤，如 404（信封未找到）。對於企業用戶，利用 DocuSign 的高級 API 計劃，其中包括 Connect API 的 webhook，用於實時狀態更新。這可以避免輪詢並減少 API 調用。

這種方法確保您可以以程式方式通知未簽名收件人、升級延遲，或與 Salesforce 等 CRM 系統集成。在商業環境中，此類自動化可以根據 DocuSign 開發者資源的行業基準，將手動跟進減少高達 70%。

DocuSign 的 API 定價從 Starter 計劃的 600 美元/年起開始（每月 40 個信封），擴展到自定義的企業選項。對於受監管行業的團隊，將此與 IAM 功能結合——如高級審計追蹤和基於角色的訪問——可以增強合規性，而無需自定義開發。

正在比較具有 DocuSign 或 Adobe Sign 的電子簽名平台？

eSignGlobal 提供更靈活且成本效益更高的電子簽名解決方案，具有全球合規性、透明定價和更快的入職流程。

👉 開始免費試用

探索 DocuSign 的生態系統和 IAM 功能

DocuSign 擴展超出基本簽名，提供集成工具，如其 Intelligent Agreement Management (IAM) 套件中的 CLM（合同生命週期管理）。IAM CLM 自動化合約創建、談判和執行，從信封中提取數據以追蹤義務。對於 API 用戶，它支持嵌入簽名儀式並將未簽名收件人數據提取到儀表板中。

在實踐中，企業使用 IAM 實現端到端可見性：信封的未簽名收件人輸入風險警報或審批工作流程。IAM 升級的定價是自定義的，通常與 Business Pro 計劃捆綁，每用戶 480 美元/年，添加治理和分析功能。

競爭格局：中立比較

電子簽名市場競爭激烈，平台在 API 深度、定價和區域合規性上有所區別。以下是關鍵玩家的 Markdown 比較表格，重點關注收件人管理的 API 功能、核心定價和優勢。數據來源於 2025 年的公開來源，以確保中立性。

此表格突出了權衡：DocuSign 在成熟生態系統中表現出色，而其他平台優先考慮可負擔性或利基優勢。

Adobe Sign：集成和 API 概述

Adobe Sign 是 Adobe Document Cloud 的一部分，強調以 PDF 為中心的流程。其 API 在收件人追蹤方面與 DocuSign 類似，使用 GET /agreements/{agreementId}/participants 來列出未簽名方。它適合創意行業，具有內置 PDF 編輯功能。定價從個人版 10 美元/月開始，擴展到企業自定義費率。Adobe 的優勢在於與 Acrobat 和營銷工具的無縫集成，但 API 配額對於高容量使用可能有限制。

HelloSign (Dropbox Sign)：適合 SMB 的簡單性

HelloSign，現為 Dropbox Sign，提供用於信封管理的簡單 API。透過 GET /v3/signature_request/{request_id} 檢索未簽名收件人，按狀態過濾。它因易用性而備受讚譽，具有內置模板和提醒功能。Essentials 版每年 180 美元，對於小團隊來說預算友好，儘管缺乏 DocuSign 的高級 IAM。

eSignGlobal：針對 APAC 優化的替代方案

eSignGlobal 將自身定位為全球競爭者，支持 100 多個主流國家和地區的合規性。它在亞太地區 (APAC) 具有特別優勢，那裡的電子簽名法規碎片化、高標準且嚴格監管——通常需要生態系統集成的深度方法，而不是美國和歐盟常見的基於框架的 ESIGN/eIDAS 模型。APAC 要求與政府到企業 (G2B) 數碼身份的深度硬件/API 級對接，這是一個遠超西方市場電子郵件驗證或自我聲明方法的技術障礙。

平台的 API 包括類似於 DocuSign 的收件人狀態查詢，在 Professional 計劃中支持批量發送和 webhook。定價具有競爭力：Essential 版本僅需 16.6 美元/月（某些促銷中相當於 199 美元/年），允許最多 100 個簽名文件、無限用戶座位和訪問代碼驗證——同時保持合規性。它與香港的 iAM Smart 和新加坡的 Singpass 無縫集成，適合跨境 APAC 操作。

正在尋找比 DocuSign 更智能的替代方案？

eSignGlobal 提供更靈活且成本效益更高的電子簽名解決方案，具有全球合規性、透明定價和更快的入職流程。

👉 開始免費試用

商業影響和推薦

從商業角度來看，DocuSign 的 API 仍是信封追蹤可靠性的基準，特別是對於全球企業。然而，隨著企業擴展到多元化地區，替代方案逐漸獲得認可。對於尋求 DocuSign 替代品的用戶，eSignGlobal 作為區域合規選項脫穎而出，尤其在 APAC，平衡成本和功能，而無需按座位收費。根據您的容量、集成和地理位置進行評估，以找到最佳匹配。