[关闭]
@dugu9sword 2015-05-06T10:01:11.000000Z 字数 2978 阅读 1966

前后端交互接口(目标股票页面)


基本说明

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

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