.Net应用调用DocuSign API v6.8.0的ListStatusChanges报错求助

针对你遇到的问题，从以下几个方向排查并修复：

1. 捕获详细异常信息 #

当前错误提示过于笼统，首先添加异常捕获，获取DocuSign返回的具体错误详情（如HTTP状态码、错误代码、描述）：

try
{
    var envelops = envelopsApi.ListStatusChanges(account.AccountId, listStatusChangesOptions);
}
catch (ApiException ex)
{
    // 打印详细错误信息
    Console.WriteLine($"Error Code: {ex.ErrorCode}");
    Console.WriteLine($"Message: {ex.Message}");
    Console.WriteLine($"ResponseBody: {ex.ResponseBody}");
}

这一步能帮你定位具体问题，比如权限不足、参数格式错误、API endpoint问题等。

2. 修正日期格式处理 #

你当前的日期格式化没有转换为UTC时间，DocuSign API要求日期参数为UTC格式。如果你的DateTime是本地时间，直接格式化会导致时间偏移，引发参数错误：

// 转换为UTC时间后再格式化
DateTime fDate = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);
DateTime tDate = new DateTime(2025, 12, 31, 23, 59, 59, DateTimeKind.Utc);
var listStatusChangesOptions = new ListStatusChangesOptions();
listStatusChangesOptions.fromDate = fDate.ToString("yyyy-MM-ddTHH:mm:ssZ");
listStatusChangesOptions.toDate = tDate.ToString("yyyy-MM-ddTHH:mm:ssZ");

3. 优化API客户端初始化逻辑 #

你重新实例化了_apiClient，可能覆盖了之前的配置或导致不必要的资源重建。建议复用原有客户端，或确保初始化正确：

// 无需重新实例化_apiClient，直接更新配置即可
_apiClient.SetBasePath(baseUri);
_apiClient.Configuration.DefaultHeader.Remove("Authorization"); // 避免重复添加
_apiClient.Configuration.DefaultHeader.Add("Authorization", "Bearer " + authToken.access_token);

4. 验证AccountId和BaseUri正确性 #

确认userInfo.Accounts[0]是你实际要操作的账户，account.BaseUri是否为正确的环境地址（如Demo环境是https://demo.docusign.net，生产环境是https://www.docusign.net），拼接后的baseUri应为https://{环境地址}/restapi。

5. 对比Postman请求参数 #

将代码中生成的请求参数（fromDate、toDate、Authorization头）与Postman中的参数逐一对比，确保完全一致，尤其是日期格式、token有效性、AccountId是否匹配。

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