获取数据集数据_V2

查询指定数据集的数据，返回字段信息和数据行。按 X-Public-User-Id 指定的用户执行，用户须有数据集模块及目标数据集的读取权限。查询遵循行列权限和脱敏规则。

鉴权

通过 X-Public-User-Id 传入凭证所属租户中已启用用户的登录账号（loginId）。
鉴权二选一：

Authorization: Bearer <access_token>，OAuth2 应用须获得 legacy-public-api:full-access scope。

X-Public-Token: <集成Token>，使用统一账户集成 Token，租户须启用统一账户集成。

示例中的 BI_BASE_URL 为 BI 服务的 API 地址前缀，例如 https://bi.example.com/backend，请按部署环境填写。

请求示例

示例按 id 升序查询前两行。请将示例数据集 ID 和字段名换成实际值。

必须发送 JSON 对象作为请求体。顶层字段均可省略，使用默认值时发送 {}。offset 默认 0，limit 默认 50000，超过 50000 时按 50000 处理。

响应

成功时 result 为 ok。response.columns 描述返回列，response.preview 是二维数组，每一项代表一行，单元格按列顺序排列。数值和日期以字符串返回，缺失值为 null。下方响应示例只展示主要字段。业务处理失败时，检查 result 和 error；鉴权失败也可能通过 HTTP 错误状态返回。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

业务响应。请检查 result。

Body

示例

{
    "result": "ok",
    "response": {
        "dsId": "d0123456789abcdef0123456",
        "columns": [
            {
                "name": "id",
                "fdType": "INT"
            },
            {
                "name": "region",
                "fdType": "STRING"
            },
            {
                "name": "amount",
                "fdType": "DOUBLE"
            }
        ],
        "colCount": 3,
        "preview": [
            [
                "1",
                "华东",
                "9"
            ],
            [
                "2",
                "华东",
                "18"
            ]
        ],
        "hitCache": false
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429429

鉴权#

请求示例#

响应#

请求参数

请求示例代码

返回响应

鉴权

请求示例

响应