使用DocuSign Admin API获取跨组织账户列表返回HTML的问题求助

以下是针对你调用API返回HTML响应的排查和解决建议：

• 检查请求头配置
  必须显式设置 Accept: application/json 请求头，DocuSign在请求出错（如认证失败、路由错误）时默认返回HTML错误页面，指定该头可确保返回JSON格式的错误信息，便于排查问题。同时确认 Authorization 头格式为 Bearer <访问令牌>，注意Bearer后需加空格，令牌无多余换行或空格。

• 验证API端点与参数

  • 确认{{organizationId}}为正确的组织ID（全局UUID格式，而非单个账户ID）；
  • 对email参数做URL编码处理，比如将@替换为%40，避免特殊字符导致请求解析错误，触发HTML跳转。

• 校验访问令牌的有效性与权限

  • 解码JWT令牌（可通过JWT解码工具），检查aud字段是否为Demo环境的正确受众值account-d.docusign.com；
  • 确认令牌的scope字段包含user_read、account_read、group_read三个权限，确保权限已正确授予集成密钥；
  • 验证生成令牌所用的集成密钥已与Admin应用关联，且关联的用户具备组织级的用户读取权限。

• 确认请求方法
  该API端点仅支持GET请求，若使用POST或其他方法，会返回HTML错误页面，需确保请求方法正确。

• 排查网络环境限制
  若本地存在企业防火墙或代理，可能导致请求被重定向到DocuSign的登录页面（返回HTML），可尝试用Postman等工具直接发起请求，排除本地网络拦截问题。

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