行业分类节点
数据集标识:index.classification_nodes;证券对象标识示例:000001.SZ
行业分类体系中的节点、层级和父子关系。
接口
| 用途 | 方法与路径 |
|---|---|
| 查询数据 | POST /v1/datasets/index.classification_nodes/query |
| 契约与当前发布 | GET /v1/datasets/index.classification_nodes |
| 准备批量快照 | POST /v1/datasets/index.classification_nodes/preparations |
请求参数
可在请求体 where 中作为 field 使用的筛选参数,名称保持契约原名。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
market | string | 否 | 市场代码;中文客户端默认 CN。 |
返回字段
列名保持契约原名,可直接用于 select、where 与结果行。
| 字段名 | 中文名称 | 类型 | 可空 | 说明 |
|---|---|---|---|---|
classification_scheme | 分类体系 | string | 否 | 分类体系 |
classification_version | 体系版本 | string | 否 | 体系版本 |
node_code | 分类节点代码 | string | 否 | 分类节点代码 |
node_name | 分类节点名称 | string | 否 | 分类节点名称 |
parent_node_code | 父节点代码 | string | 是 | 父节点代码 |
classification_level | 分类层级 | integer | 否 | 分类层级 |
has_published_index | 是否发布指数 | boolean | 是 | 是否发布指数 |
published_index_code | 已发布指数代码 | string | 是 | 已发布指数代码 |
请求示例
向 https://api.<环境域名>/v1/datasets/index.classification_nodes/query 发送 POST 请求(服务地址的替换方式见快速开始),请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json,请求体如下:
{
"select": [
"classification_scheme",
"classification_version",
"node_code",
"node_name",
"parent_node_code",
"classification_level",
"has_published_index",
"published_index_code"
],
"where": [
{
"field": "market",
"op": "eq",
"value": "CN"
}
],
"page": {
"limit": 1000,
"cursor": null
}
}
响应示例
实际结果随数据更新而变化;data 为空数组表示请求范围内没有可返回的记录。
{
"datasetId": "index.classification_nodes",
"fields": [
"classification_scheme",
"classification_version",
"node_code",
"node_name",
"parent_node_code",
"classification_level",
"has_published_index",
"published_index_code"
],
"data": [],
"page": {
"nextCursor": null,
"complete": true
}
}