如何在Appian Connected System中刷新DocuSign访问令牌

前置校验 #

首先确认你申请DocuSign授权时已经添加了offline_access权限，没有该权限DocuSign不会下发刷新令牌，无法执行后续刷新操作。

自动刷新配置（优先方案，无需人工介入） #

• 进入已创建的DocuSign Connected System配置页面，找到身份验证设置模块
• 勾选「自动刷新访问令牌」选项，Appian会自动存储授权返回的refresh_token参数，在访问令牌过期前15分钟自动发起刷新请求
• 保存配置后即可生效，后续令牌刷新操作由Appian自动完成，不需要手动重新验证

手动刷新操作步骤 #

配置页直接刷新 #

直接在Connected System配置页点击重新验证按钮，走一次完整授权流程，会同时更新访问令牌和刷新令牌，有效期直接重置。

自定义逻辑调用刷新 #

如果需要在自己的集成逻辑中控制刷新时机，可以直接调用DocuSign令牌刷新接口：

请求方法：POST
沙箱请求地址：https://account-d.docusign.com/oauth/token
生产请求地址：https://account.docusign.com/oauth/token
必传表单参数：

• grant_type：固定值 refresh_token
• refresh_token：上一次授权获取的刷新令牌值
• client_id：你的DocuSign应用客户端ID
• client_secret：你的DocuSign应用客户端密钥
  接口调用成功后会返回新的access_token和refresh_token，替换原有存储的两个值即可。

常见问题排查 #

• 刷新请求返回invalid_grant错误：说明当前刷新令牌已过期或被吊销，需要重新走完整的授权码验证流程获取新的令牌组合
• Appian未触发自动刷新：首先检查授权请求的scope参数是否包含offline_access，其次检查Connected System配置中是否启用了自动刷新开关

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