如何通过DocuSign REST V2 API获取信封的通用JSON响应

当你调用GET /v2/accounts/{accountId}/envelopes/{envelopeId}接口时，默认返回的是信封的精简核心元数据（也就是你提到的24个属性）。要拿到文档里展示的包含更多属性和关联数据的“通用JSON响应”，只需要通过添加查询参数扩展返回内容即可：

• 用include参数指定关联资源：这个参数可以让你指定要包含在响应里的关联实体，多个值用逗号分隔。比如要获取收件人、文档、签名标签和文件夹信息，调用的URL应该是：

  GET /v2/accounts/{accountId}/envelopes/{envelopeId}?include=recipients,documents,tabs,folders
  

  如果你想一次性获取所有可用的关联资源，也可以直接用include=all，不过这可能会返回一些你不需要的数据，建议按需指定具体的资源类别更高效。

• 搭配include_extended_status获取细致状态：如果需要更深入的信封状态细节（比如每个收件人的操作记录、时间线等），可以加上这个参数进一步扩展响应：

  GET /v2/accounts/{accountId}/envelopes/{envelopeId}?include=recipients,documents&include_extended_status=true
  

默认接口只返回信封的基础标识、状态和时间戳等核心字段，通过上述参数组合，就能让响应包含收件人详情、文档内容、签名位置、文件夹归属等额外数据，和文档里的“通用JSON响应”结构完全匹配。

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