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，平衡成本和功能，而无需按座位收费。根据您的容量、集成和地理位置进行评估，以找到最佳匹配。