三、财务信息
3.1 公司介绍(多语言)
GET
/api/symbol_international_details公司名称、简介、板块、行业、CEO、官网等 12 个字段,按语言取。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家,如 america;全部取值见「国家与市场参数」 |
| market | 必填 | 市场代码,如 NASDAQ |
| symbol | 必填 | 产品代码,如 AAPL;代码里有 & 时要写成 %26 |
| language | 必填 | 语言,如 en;每个国家支持的语言见「国家与市场参数」 |
说明
data固定 12 个字段:country、name、description、sector、industry、ceo、website、head_office、founded、type、language、indexes;没有内容的为空字符串。indexes目前固定为"[]"。- 这个产品没有所传语言的介绍时返回 No Symbol(比如美股传 ja)。en 覆盖最全。
- 外壳里带 market、symbol、code。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval},数据在 data 里。出错时 HTTP 状态码仍是 200,status 为 500,message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 market is required! / symbol is required! | 缺少 market 或 symbol |
| 200 | status=500 No Symbol | 找不到这个产品,或这个产品没有这类数据 |
| 200 | status=500 language is required! | 没传 language |
示例
GET
/symbol_international_details?country=america&market=NASDAQ&symbol=AAPL&language=en请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 数据
"country": "america", // 国家
"website": "http://www.apple.com", // 官网
"founded": "1976", // 成立年份
// 公司简介
"description": "Apple is among the largest companies in the world, with a broad portfolio of hardware and software products targeted at consumers and businesses. Apple's iPhone accounts for the majority of the firm's sales, and Apple's …",
"language": "en", // 语言
"industry": "Computers, Phones & Household Electronics", // 行业
"type": "stock", // 类型
"ceo": "John Ternus", // 首席执行官
"indexes": "[]", // 目前固定为 "[]"
"head_office": "Cupertino", // 总部所在地
"name": "Apple Inc", // 公司名称
"sector": "Technology" // 板块
},
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": "NASDAQ", // 市场代码
"symbol": "AAPL", // 产品代码
"code": "AAPL", // 产品代码
"interval": null // K 线周期,这类接口不用
}