高管背景
GET/v1/quote/{symbol}/f10/executive-background获取指定高管的详细背景简介。须先通过公司高管接口获取 leader_name,再传入本接口查询单个高管的长文本背景资料。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 标的代码,如 HK.00700。 |
leader_name | string | 查询 | 是 | 高管姓名,须严格相等于公司高管接口返回的 leader_name 字段。 |
请求示例
bash
curl -G "$ip/v1/quote/HK.00700/f10/executive-background" \
--data-urlencode "leader_name=马化腾" | jq响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
brief_background | string | 高管背景简介长文本。 |
限制范围
- 支持市场:HK / US(其他市场暂无该接口数据)。
- 支持品类:正股。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| -3 | invalid_parameter | 缺 leader_name 参数 | 补全请求参数 |
| -7 | invalid_symbol | symbol 在证券库中查不到 | 通过 search 接口确认代码合法性 |
| -10 | no_data | leader_name 不匹配或无背景数据 | 先调用公司高管接口拿到准确的 leader_name |
| -4 / -6 | internal_error | 网关请求构造或响应映射失败 | 重试,仍失败请联系网关侧 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"brief_background": "Ma Huateng, Executive Director, Chairman of the Board, and Chief Executive Officer of the Company. Mr. Ma is fully responsible for the Group's strategic planning, positioning, and management. ..."
}
}