@dugu9sword
2015-05-06T10:01:11.000000Z
字数 2978
阅读 1934
状态码 code
状态信息 state
以及返回值。状态码 code
有两个可能的值,200
表示成功,500
表示失败。 以登录为例:如果登录成功,状态码为 200,状态信息为 OK;如果用户密码, 状态码为 500,状态信息为 Wrong Password。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\"}]"}