Python调用Tableau Online metadata/graphiql接口返回HTML而非JSON求助

核心问题 #

你调用的/metadata/graphiql是Tableau的GraphQL交互式调试界面，返回的是网页HTML，并非API接口的JSON响应。正确的API端点应该是/metadata/api/graphql。此外，Tableau Online的API请求必须携带有效认证信息，否则会返回错误或非预期内容。

修正步骤 #

• 替换为正确的API URL
  把graphql_url改为https://<server-name>/metadata/api/graphql；如果你的Tableau站点不是默认站点，需加上站点ID：https://<server-name>/site/<site-id>/metadata/api/graphql
• 添加认证信息
  推荐使用个人访问令牌（PAT）认证：
  1. 登录Tableau Online，进入账户设置→个人访问令牌，创建令牌并保存好令牌名称和密钥
  2. 在请求头中带上Authorization: Bearer <pat-name>:<pat-secret>
• 确保请求格式正确
  保持json={'query': metadata_query}的参数格式，同时指定Content-Type: application/json请求头

修改后的代码 #

import requests

# 替换为你的实际信息
server_name = "<server-name>"
site_id = "<your-site-id>"  # 默认站点留空字符串""
pat_name = "<your-pat-name>"
pat_secret = "<your-pat-secret>"

# 构造正确的API地址
if site_id:
    graphql_url = f"https://{server_name}/site/{site_id}/metadata/api/graphql"
else:
    graphql_url = f"https://{server_name}/metadata/api/graphql"

metadata_query='''
query {
  workbooks{
    name
    }
  }'''

# 设置请求头
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {pat_name}:{pat_secret}"
}

response = requests.post(graphql_url, json={'query': metadata_query}, headers=headers)

if response.status_code == 200:
    try:
        print(response.json())
    except ValueError:
        print("返回内容不是JSON，请检查认证信息和URL是否正确")
else:
    print(f'错误状态码: {response.status_code}')
    print('错误详情:', response.text)

额外说明 #

• 若不想使用PAT，也可以用用户名+密码先获取会话令牌，但PAT更安全且无需重复登录
• 站点ID可从Tableau Online的URL中获取：比如访问站点时URL为https://<server-name>/site/my-site，站点ID就是my-site

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