# 企业主要人员查询API

**请求方式：** GET

**接口地址：** https://v2.xxapi.cn/api/staff

**接口描述：** 免费API提供专业的企业主要人员信息查询服务，支持通过公司名称、企业ID、统一社会信用代码等方式快速获取企业主要人员详细数据。接口可返回董事、监事、高级管理人员姓名、职位、任职信息、主要人员总数、法定代表人及核心管理层等字段内容，帮助用户全面了解企业组织架构与核心管理团队情况。适用于企业背景调查、商业合作核查、企业信用评估、供应商管理、投资尽调、金融风控及工商信息分析等多种业务场景。接口支持高并发访问、实时数据更新、多格式输出，确保企业主要人员查询结果的准确性、完整性与稳定性，为企业信息管理与风险控制提供可靠的数据支持。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| keyword | 搜索关键字 | query | 必传 | — | — | 搜索关键字（公司名称、社会统一信用代码） |
| pageNum | 页数 | query | 可选 | — | — | 当前页数（默认第1页） |
| pageSize | 条数 | query | 可选 | — | — | 每页条数（默认20条，最大20条） |
| Authorization | Bearer <access_key> | header | 必传 | Bearer <access_key> | — | 请登录后前往控制面板查询 API Key |

## 返回示例

```json
{
  "code": 200,
  "msg": "数据请求成功",
  "data": {
    "total": 1, // 主要人员总数
    "items": [
      {
        "id": 1923977966, // 人员 ID
        "hcgid": "1923977966-c7556013708", // 人员 hcgid
        "name": "张子阳", // 主要人员名
        "type": 2, // 类型：2 表示人
        "typeJoin": [
          "董事",
          "经理",
          "财务负责人"
        ], // 职位列表
        "logo": "" // logo 地址
      }
    ]
  },
  "request_id": "50efaadb7fc925620485e605"
}
```