如何通过DocuSign信封ID公开获取文档URL及Powerform签署后文档？

一、解决无法获取信封文档的问题 #

• 权限验证：确认调用API的账号拥有目标信封的访问权限。如果Powerform由其他账号创建，当前API账号需是信封发起者、已被共享权限，或使用了对应有权限账号的集成密钥。
• 信封状态确认：仅当信封状态为completed时，才能获取完整签署文档。先调用GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}确认状态，若为sent或in_process，说明文档尚未最终生成。
• 使用正确API接口：Get Envelopes API是批量查询信封列表的接口，无法直接获取文档。正确接口为：
  • 获取合并后的单文档：GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/combined
  • 获取所有文档列表后单独拉取：GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents
• 认证检查：确保请求头的Bearer Token有效、未过期，且账号关联正确的accountId，JWT认证需包含envelopes.read权限范围。

二、生成信封文档的临时公开访问URL #

DocuSign不支持永久公开URL，但可生成有有效期的临时公开链接，步骤如下：

1. 调用POST /v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/combined/views接口创建查看链接
2. 请求体示例（无需认证即可访问）：

{
  "returnUrl": "https://your-domain.com/return",
  "authenticationMethod": "none",
  "duration": 3600 // 链接有效期（秒），最大支持14400（4小时）
}

3. 接口返回的url字段即为临时公开链接，有效期由duration参数控制

注意：仅已完成（completed）的信封可生成此类链接，到期后需重新调用接口生成新链接。

内容的提问来源于stack exchange，提问作者Bhavin Thummar