如何不借助API Explorer调用DocuSign API下载模板PDF文档

前置准备工作 #

• 先在DocuSign开发者后台创建集成应用，获取3类核心信息：
  • 授权相关：集成密钥（Integration Key）、RSA密钥对、*授权范围（scope）*需配置signature和impersonation权限
  • 账号相关：你的开发者账户ID（Account ID）、操作用户的用户ID（User ID）
  • 模板相关：提前整理好你要下载的500个模板的模板ID列表
• 选择调用方式：仅测试单条请求可以用curl、Postman这类工具，批量自动下载可以选择Python、Node.js等开发语言，优先用DocuSign官方对应语言的SDK，避免手动处理签名、请求构造的问题。

完整调用步骤 #

沙箱环境请求基础域名是https://demo.docusign.net/restapi，生产环境替换为你账号对应区域的官方域名

1. 获取访问令牌（Access Token） #

所有API请求都需要在请求头中携带访问令牌，服务端批量场景推荐用JWT授权方式获取令牌，令牌有效期为1小时，过期后重新获取即可。
拿到令牌后，所有后续请求的Header都需要添加参数：Authorization: Bearer {实际获取的访问令牌}

2. 构造下载请求 #

TemplateDocuments:get接口的请求规则为：
GET /v2.1/accounts/{你的账户ID}/templates/{对应模板ID}/documents/{文档ID}
如果不清楚单模板下的文档ID，可以先调用模板文档列表接口GET /v2.1/accounts/{你的账户ID}/templates/{对应模板ID}/documents获取该模板下所有文档的ID，单文档模板的默认文档ID一般为1。

3. 接收并保存PDF #

请求发送成功后，接口会返回二进制格式的PDF文件流，直接将返回内容保存为.pdf后缀的本地文件即可。
批量下载只需要遍历你提前整理的模板ID列表，循环执行上述请求逻辑即可完成500个模板的下载。

单请求测试示例（curl命令） #

curl --location 'https://demo.docusign.net/restapi/v2.1/accounts/替换为你的账户ID/templates/替换为目标模板ID/documents/1' \
--header 'Authorization: Bearer 替换为你获取的有效访问令牌' \
--output 自定义保存的文件名.pdf

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