[关闭]
@dugu9sword 2015-05-08T03:30:52.000000Z 字数 5625 阅读 1620

前后端交互接口(目标股票 & 目标分析师)

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

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注