前后端交互接口（目标股票页面）

---

基本说明

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\"}]"}