Skip to content

数据解释(带因子数据)

本接口在 v3.39.0 版本中引入

  • 本接口和 PC 端数据解释返回结构一致。仅用于测试,会随着功能迭代,返回值可能会有变化。
  • 在调用本接口前,确保你已经创建了工作区,并且用户加入了工作区成为了成员

请求方式

Request Method: GET
Request URL:    /openapi/v1/workspaces/{workspaceId}/data/insights/?memberUid={memberUid}&text={text}
Request Header:
  Authorization: "{连接密钥}"

请求参数说明

参数 类型 是否必填 说明
workspaceId string 是 用户工作区的 id
连接密钥 string 是 API密钥
memberUid string 是 工作区中成员的 uid
text string 是 成员提的问题,比如“今年每月营业额”,需要该问题的第一张卡片可以生成数据解释

返回结果

返回结果的 data 内为列表,每项为这个问题不同角度的数据解释。返回结构会随着功能迭代升级而有所变化。使用前请做好防御性和兼容性处理。

  • 如果工作区关闭数据解释或卡片没有数据解释,会返回 400 错误
{
  "errcode": 400,
  "errmsg": "用户问题无法搜索出数据解释"
}
  • 数据解释任务执行失败,会返回 400 错误
{
  "errcode": 400,
  "errmsg": "获取数据解释内容失败:{错误信息}"
}
  • 获取数据解释超时,会返回 400 错误
{
  "errcode": 400,
  "errmsg": "获取数据解释超时"
}
  • 数据解释任务执行成功,但无返回结果,会返回 400 错误
{
  "errcode": 400,
  "errmsg": "获取数据解释失败"
}