上一个刷新令牌过期后，如何请求新的刷新令牌？

Question

我有两个用于文档签名的帐户：实时帐户和演示帐户。演示版已经有一段时间没有使用了，事实上，上次创建刷新令牌是在 11 月 14 日。因此，我假设它已经过期，并且可能会阻止我购买新的。

当我提出请求时，我收到 invalid_grant 错误。相同的代码（带有测试凭据）适用于我的真实帐户，该帐户每隔几天左右请求一次实时令牌。在长期不使用之前，它在测试凭据方面也确实工作得很好。

我认为我需要获得一个新的刷新令牌，但如果没有有效的先前令牌，我不知道如何处理这个问题。

Answer 1

以下内容适用于 DocuSign 的 OAuth2 身份验证服务：

当您使用刷新令牌获取新的访问令牌时，您还会获得新的刷新令牌。但请参阅以下内容：

如果您的原始 OAuth 请求仅包含signature范围，则新刷新令牌的到期日期将与原始刷新令牌相同（30 天）。

但是，如果您同时请求signature和extended范围，那么您的新刷新令牌将在刷新后 30 天后过期。

因此，您可以继续获取新的访问令牌而不需要用户再次进行身份验证的方法是：

1. 用户使用signature和extended范围进行身份验证。您的应用程序将身份验证代码交换为访问令牌（有效期为 8 小时）和刷新令牌（有效期为 30 天）。
2. 在 30 天内，刷新访问令牌。这还为您提供了一个新的刷新令牌，适用于新的 30 天期限。
3. 冲洗并重复。只要您至少每 30 天获得一个新的刷新令牌，您就可以永远继续下去。

警告：出于信息安全原因，最终用户、其管理员和/或 DocuSign 可能会使所有现有刷新令牌失效。这是一个不寻常的极端情况，但也有可能发生。测试极端情况的最简单方法：删除用户对应用程序的同意。