DocuSign Code Grant Token失效问题及文档访问URI获取咨询

问题1：Code Grant授权模式令牌异常排查 #

• 先校验请求头是否正确配置授权信息，标准OAuth2请求格式为Authorization: Bearer {获取到的access_token}，缺少Bearer前缀、令牌拼写错误或请求头位置配置错误，都会导致令牌验证失败，功能无法正常运行
• 不要复用前一天生成的access token，常规access token有效期仅为1~24小时，过期后必然返回授权报错。正确处理逻辑为：每次发起业务请求前先校验access token有效期，过期后主动调用刷新接口，使用refresh token换取新的access_token后再发起请求；若refresh token本身也超出有效期，则需要重新走Code Grant授权流程获取新的refresh token和access token
• 检查授权时申请的scope权限是否匹配你调用的业务接口要求，scope范围不足也会出现令牌下发成功但业务接口无访问权限的问题

问题2：文档访问直链生成方案 #

你需要的文档状态查看、下载直链为平台标准路径格式，结构为https://{你的平台域名}/{accountid}/{envelopeid}/{documentid}，各参数获取逻辑如下：

• accountid：你的开发者账户唯一标识，可直接在平台开发者后台的账户信息板块获取
• envelopeid：文档签署任务的唯一ID，在你调用接口创建签署任务时，会随返回参数下发，创建任务后需自行存储该值
• documentid：签署任务下对应单份文件的唯一标识，创建任务时上传的每份文件都会对应下发唯一的documentid，需自行关联存储
  将三个参数按上述格式拼接完成后即可生成可用直链，用户点击链接后可直接跳转至对应页面，查看文档当前签署状态、进度，也可直接下载源文件或已完成签署的文件

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