主要人员列表API接口查询
查询企业主要人员信息（含当前或历史主要人员；姓名、职务、任职开始/退出日期、股份份额等）。filters.id 必填（也可用顶层 query）：企业ID。filters.isHistory 选填：0=当前（默认）；1=历史主要人员。有分页：顶层 top_k 为每页条数，filters.offset 为翻页偏移。
已开放
调用入口：POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域（必填） | enterprise |
| type | string | 数据类型（必填） | key_person |
| query | string | 自然语言检索词 | 5bb6be9aa9ae9a74da456375 |
| filters | object | 结构化过滤条件，见下方「常用 filters」 | — |
| top_k | integer | 分页参数：每页条数，取值范围 1–100，本能力默认 20 | 20 |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| id | string | 企业标识（必填；企业ID；也可用 query） | 5bb6be9aa9ae9a74da456375 |
| isHistory | integer | 是否历史主要人员（选填；0=否/默认，1=是） | 0 |
| offset | integer | 分页参数：偏移量（默认 0；配合顶层 top_k 翻页，建议为 top_k 的整数倍） | 0 |
返回字段（hits[]）
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 姓名 |
| position | string | 职位/主要职务 |
| startDate | integer | 任职开始时间（Unix 秒） |
| endDate | integer | 任职退出日期（Unix 秒） |
| shareOfShares | string | 股份份额 |
| finalBenefitShares | string | 最终受益股份 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"enterprise", "type":"key_person", "query":"5bb6be9aa9ae9a74da456375", "filters":{ "id":"5bb6be9aa9ae9a74da456375" }, "top_k":20 }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。