高管背景
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. ..."
}
}