Loading

使用 Tableau REST API 时出现间歇性 HTTP 401 或 403 错误

发布日期: Aug 25, 2025
描述
当使用 REST API 进行调用时,会间歇性地收到 400 错误响应(通常是 401 或 403)。

响应可能类似于以下内容:
<?xml version='1.0' encoding='UTF-8'?> 
tsResponse xmlns="http://tableau.com/api" xmlns:xsi="http://ww.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://tableau.com/api http://tableau.com/api ts-api-2.3.xsd"> 
<错误代码="401000"> 
<summary>未经授权的访问</summary> 
<detail>未提供身份验证凭据</detail> 
</error> 
</tsResponse>

Cause

使用 REST API 时,间歇性的 4xx 错误通常是由于使用的身份验证令牌比 Tableau Server 配置接受的令牌长而导致的。 
解决方案
  • 确保您的 REST API 代码在 Tableau Server 上的每个会话超时足够频繁地检索新的身份验证令牌。
  • 默认情况下,身份验证令牌的有效期为 240 分钟。(您可以通过调用 tabadmin set 命令来更改 wgserver.session.idle_limit 设置,从而为令牌指定不同的超时值。)
  • 如果您的应用程序需要能够在令牌过期后进行额外的调用,您可以再次调用“登录”并获得新的身份验证令牌。
  • 有关在 REST API 调用中使用身份验证令牌的更多信息,请参阅登录和注销(身份验证)
其他资源
  • 在出现一致的 401/403 错误的情况下,可能是没有有效的身份验证令牌随请求传入,或者调用是针对用户登录的站点之外的站点。
  • 如果收到实际的 400 错误,此响应表示请求错误,而不是身份验证问题。在这种情况下,请务必检查您的请求的正文,以确保所有内容均准确,并且位于正确的位置。请参考 REST API 文档,了解语法要求。


知识文章编号

001498381

 
正在加载
Salesforce Help | Article