前后端交互接口（目标股票 & 目标分析师）

2015年5月8日 更新记录

• 更新目标分析师页面接口

---

基本说明

1. 前端通过 HTTP/GET 发出请求，后端返回 JSON 格式，编码为 UTF-8
2. 返回格式包含 状态码 code 状态信息 state 以及返回值。状态码 code有两个可能的值，200 表示成功，500 表示失败。 以登录为例：如果登录成功，状态码为 200，状态信息为 OK；如果用户密码， 状态码为 500，状态信息为 Wrong Password。
3. 服务器地址 http://stock.whytouch.com

---

目标股票页面

获取股价信息

接口地址
/stockpages/get_stock_price.php

输入参数

参数名	说明
s_id	必填 股票 ID
days	选填 所需股价天数，默认为 60
need_basic_info	选填 是否需要基本信息，默认为 false

返回值

参数名	说明
code	状态码
state	状态信息
basic_info	股票基本信息，包含 股票名 name 期望价格 expected_price 昨日收盘 yesterday_price 涨/跌 up 研报数 num_of_researches
price	JSON 数组，数组每个元素由 日期 date 价格 price 组成

样例
查询 ID 为 1 的股票前 2 天的股价，同时返回股票的基本信息

输入

http://stock.whytouch.com/stockpages/get_stock_price.php?s_id=1&days=2&need_basic_info=true

输出

{"code":200,"state":"OK","basic_info":"{\"name\":\"Apple\",\"expected_price\":\"32.12\",\"yesterday_price\":\"18.67\",\"up\":true,\"num_of_researches\":3}","price":"[{\"date\":\"20150531\",\"price\":\"16.55\"},{\"date\":\"20150530\",\"price\":\"18.26\"}]"}

获取不同分析师的分析

接口地址
/stockpages/get_analysis.php

输入参数

参数名	说明
s_id	必填 股票ID
page	选填 查询第 page 页，默认为 0
need_basic_info	选填 是否需要基本信息，默认为false

返回值

参数名	说明
code	状态码
state	状态信息
basic_info	股票基本信息，同上
analysis	JSON 数组，数组每个元素由 目标价 target_price 收益率 yield_rate 分析师ID a_id 分析师名字 a_name 组成

样例 1
查询 ID 为 1 的股票的分析师分析，默认查询第 0 页，默认不需要股票的基本信息

输入

http://stock.whytouch.com/stockpages/get_analysis.php?s_id=1

输出

{"code":200,"state":"OK","analysis":"[{\"target_price\":\"18.3\",\"yield_rate\":\"0.3\",\"a_id\":\"1\",\"a_name\":\"Steve Jobs\"},{\"target_price\":\"10\",\"yield_rate\":\"0.9\",\"a_id\":\"3\",\"a_name\":\"Zuckerberg\"}]"}

样例 2
查询 ID 为 1 的股票的分析师分析，查询第 1 页，需要股票的基本信息。此时返回了股票的基本信息 basic_info ，同时由于第 1 页没有数据，返回 analysis 为空数组。

输入

http://stock.whytouch.com/stockpages/get_analysis.php?s_id=1&page=1&need_basic_info=true

输出

{"code":200,"state":"OK","basic_info":"{\"name\":\"Apple\",\"expected_price\":\"32.12\",\"yesterday_price\":\"18.67\",\"up\":true,\"num_of_researches\":5}","analysis":"[]"}

获取某个分析师对某张股票发过的研报

接口地址
/stockpages/get_researches_by_analyzer.php

输入参数

参数名	说明
s_id	必填 股票ID
a_id	必填 分析师ID

返回值

参数名	说明
code	状态码
state	状态信息
researches_by_analyzer	JSON 数组，数组每个元素由 研报标题 title 日期 date 组成

样例
查询 ID 为 1 的分析师对 ID 为 1 的股票的分析

输入

http://stock.whytouch.com/stockpages/get_researches_by_analyzer.php?s_id=1&a_id=1

输出

{"code":200,"state":"OK","researches_by_analyzer":"[{\"title\":\"gsdfg34gt356547hfghdgh54hds\",\"date\":\"20150403\"},{\"title\":\"qwertyuiopasdfgfwer4542454\",\"date\":\"20150402\"}]"}

获取某张股票的所有研报

接口地址
/stockpages/get_researches.php

输入参数

参数名	说明
s_id	必填 股票ID
page	选填 查询第 page 页，默认为 0
need_basic_info	选填 是否需要基本信息，默认为false

返回值

参数名	说明
code	状态码
state	状态信息
basic_info	股票基本信息
researches	JSON 数组，数组每个元素由 研报标题 title 日期 date 分析师ID a_id 分析师姓名 a_name 组成

样例
查询 ID 为 1 的股票的所有研报

输入

http://stock.whytouch.com/stockpages/get_researches.php?s_id=1

输出

{"code":200,"state":"OK","researches":"[{\"title\":\"35289gydfsghshalhl4ghldgghag\",\"date\":\"20150602\",\"a_id\":\"3\",\"a_name\":\"Zuckerberg\"},{\"title\":\"gsdfg34gt356547hfghdgh54hds\",\"date\":\"20150403\",\"a_id\":\"3\",\"a_name\":\"Zuckerberg\"},{\"title\":\"gsdfg34gt356547hfghdgh54hds\",\"date\":\"20150403\",\"a_id\":\"1\",\"a_name\":\"Steve Jobs\"},{\"title\":\"qwertyuiopasdfgfwer4542454\",\"date\":\"20150402\",\"a_id\":\"1\",\"a_name\":\"Steve Jobs\"}]"}

---

分析师页面

获取分析师信息及其属性

接口地址
/analyzerpages/get_analyzer_info.php

输入参数

参数名	说明
a_id	必填 分析师 ID

返回值

参数名	说明
code	状态码
state	状态信息
basic_info	分析师基本信息，包含 姓名 a_name 头像 portrait 所属机构 a_institution 职务 a_position 关注的股票 following_stocks 。其中 关注的股票 following_stocks 是一个数组，包含 股票ID s_id 股票名称 s_name
attribute	分析师属性，包含 稳定性 stability 速度 speed 精确度 accuracy 高估程度 overestimation 低估程度 underestimation

样例
查询 ID 为 1 分析师基本信息

输入

http://stock.whytouch.com/analyzerpages/get_analyzer_stock.php?a_id=1

输出

{"code":200,"state":"OK","analyzer_stock":"[{\"date\":\"20150403\",\"s_name\":\"Apple\",\"target_price\":\"10\",\"yield_rate\":\"0.9\",\"drift_rate\":\"0.98\"},{\"date\":\"20150302\",\"s_name\":\"Tencent\",\"target_price\":\"11.3\",\"yield_rate\":\"0.9\",\"drift_rate\":\"0.8\"}]"}

获取该分析师对不同股票的分析

接口地址
/analyzerpages/get_analyzer_stock.php

输入参数

参数名	说明
a_id	必填 分析师ID
page	选填 查询第 page 页，默认为 0
need_basic_info	选填 是否需要分析师基本信息，默认为false

返回值

参数名	说明
code	状态码
state	状态信息
basic_info	分析师基本信息，同上
analyzer_stock	JSON数组，包含分析师对股票的分析，每个元素由 发布日期 date 股票ID s_id 股票名称 s_name 目标价 target_price 收益率 yield_rate 偏移度 drift_rate 构成

样例
查询 ID 为 1 的分析师对股票的分析，查询第 0 页，不需要分析师的基本信息

输入

http://stock.whytouch.com/analyzerpages/get_analyzer_stock.php?a_id=1

输出

{"code":200,"state":"OK","analyzer_stock":"[{\"date\":\"20150403\",\"s_id\":\"1\",\"s_name\":\"Apple\",\"target_price\":\"10\",\"yield_rate\":\"0.9\",\"drift_rate\":\"0.98\"},{\"date\":\"20150302\",\"s_id\":\"3\",\"s_name\":\"Tencent\",\"target_price\":\"11.3\",\"yield_rate\":\"0.9\",\"drift_rate\":\"0.8\"}]"}

获取分析师对某张股票发过的研报

接口地址
analyzerpages/get_researches_by_stock.php

输入参数

参数名	说明
s_id	必填 股票ID
a_id	必填 分析师ID

返回值

参数名	说明
code	状态码
state	状态信息
stock_research	JSON 数组，数组每个元素由 研报标题 title 日期 date 组成

样例
查询 ID 为 1 的分析师对 ID 为 1 的股票的分析

输入

http://stock.whytouch.com/stockpages/get_researches_by_analyzer.php?s_id=1&a_id=1

输出

{"code":200,"state":"OK","stock_research":"[{\"title\":\"gsdfg34gt356547hfghdgh54hds\",\"date\":\"20150403\"},{\"title\":\"qwertyuiopasdfgfwer4542454\",\"date\":\"20150402\"}]"}

获取某个分析师发过的所有研报

接口地址
/analyzerpages/get_researches.php

输入参数

参数名	说明
s_id	必填 股票ID
page	选填 查询第 page 页，默认为 0
need_basic_info	选填 是否需要基本信息，默认为false

返回值

参数名	说明
code	状态码
state	状态信息
basic_info	股票基本信息
researches	JSON 数组，数组每个元素由 研报标题 title 日期 date 分析师ID a_id 分析师姓名 a_name 组成

样例
查询 ID 为 1 的分析师发的所有研报

输入

stock.whytouch.com/analyzerpages/get_researches.php?a_id=1

输出

{"code":200,"state":"OK","basic_info":"{\"a_name\":\"Steve Jobs\",\"portrait\":\"1\",\"a_institution\":\"Apple\",\"a_position\":\"CEO\",\"following_stocks\":\"[{\\"s_id\\":\\"1\\",\\"s_name\\":\\"Apple\\"},{\\"s_id\\":\\"2\\",\\"s_name\\":\\"goooogle\\"}]\"}","researches":"[{\"title\":\"qwertyuiopasdfgfwer4542454\",\"date\":\"20150402\"},{\"title\":\"fsdfw425rsdgergsdag3g45rge\",\"date\":\"20150302\"},{\"title\":\"gsdfg34gt356547hfghdgh54hds\",\"date\":\"20150403\"}]"}