@hbec-public
2016-10-18T01:47:36.000000Z
字数 2616
阅读 790
接口文档 模块划分
DEV和仿真对接同一套ABOSS环境
| 环境 | 账号 | 客户号 |
|---|---|---|
| DEV | 13800000010 | 020090047535 |
| 仿真 | 13800000010 | 020090047535 |
新股申购相关接口均为私有、加密接口。
说明
查询当日可申购新股数、已申购次数、已中签次数等
方法名
inewSharesController.queryCounts
调用示例
/inewSharesController.queryCounts
参数列表
无
响应结构
{"data":{"currentDate": 1475036918877,"currentPurchasable": 0,"purchasedCount": 30,"awardedCount": 4,"availableCapital": "984908.61","currentAwardedCount": 0,"conditionProperties": {"warnId": 123,"strategyState": 1,"purchaseTarget": 0,"maxCount": 10,"purchaseTime": "14点30分","purchasedCount": 2}},"message":"","result":"1"}
响应字段说明
| 字段名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| currentDate | long | Y | 时间戳 |
| currentPurchasable | int | Y | 当日可申购新股个数 |
| purchasedCount | int | Y | 已申购次数 |
| awardedCount | int | Y | 已中签次数 |
| availableCapital | String | Y | 可用资金 |
| currentAwardedCount | int | Y | 当前中签个数 |
| conditionProperties | Object | N | 自动打新条件单,可能为null |
| warnId | int | Y | 条件单ID |
| strategyState | int | Y | 条件单状态 |
| purchaseTarget | int | Y | 申购目标,见数据字典 |
| maxCount | int | Y | 最大申购次数,-1表示无限次 |
| purchaseTime | Long | Y | 申购时间,毫秒值,仅时分秒部分,注意按东八区时区处理 |
| purchasedCount | int | Y | 已申购次数 |
说明
查询交易权限、申购额度
方法名
inewSharesController.queryPurchaseQuota
调用示例
/inewSharesController.queryPurchaseQuota
参数列表
无
响应结构
{"data":[{"permissionName":"沪A权限","permissionState":1,"permissionType":"SH","purchaseQuota":2000},{"permissionName":"深A权限","permissionState":0,"permissionType":"SZ","purchaseQuota":0},{"permissionName":"创业板权限","permissionState":0,"permissionType":"SZ_GEM","purchaseQuota":0}],"message":"","result":"1"}
响应字段说明
| 字段名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| data | List | Y | 配售额度对象列表 |
| permissionType | String | Y | 交易权限类别,数据字典 |
| permissionName | String | Y | 交易权限名称 |
| permissionState | int | Y | 交易权限状态,0未开通1已开通 |
| purchaseQuota | int | Y | 申购额度(单位:股) |
说明
分页查询已申购记录
基于browIndex的分页查询流程:
查询第一页,browIndex传空,保存返回值中的browIndex值;
查询下一页,browIndex传递上次调用返回的browIndex值,保存返回值中browIndex用于下次调用;
返回列表为空,或browIndex值不再变化时,没有更多数据
由于数据必须从ABOSS查询,因此必须按照ABOSS的分页查询方式来查
注意每页行数不固定,但每页至少10行数据
方法名
inewSharesController.queryPurchaseHistory
调用示例
/inewSharesController.queryPurchaseHistory?pager={'browIndex':'2016-08'}
参数列表
| 字段名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| pager | Object | N | 分页参数 |
| browIndex | String | N | 定位串,客户端不需要关心具体值,传空返回第一页 |
响应结构
{"data":{"browIndex":"aaa1","list":[{"beginNumber":"234363743","numberCount":1,"purchaseCode":"000001","purchaseName":"叉叉申购","purchaseState":0,"purchaseTime":"14:57:00"},{"beginNumber":"23436232343","numberCount":1,"purchaseCode":"000002","purchaseName":"某某申购","purchaseState":1,"purchaseTime":"2016-09-12"}],"rowCount":2},"message":"","result":"1"}
响应字段说明
| 字段名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| browIndex | String | Y | 定位串 |
| rowCount | int | Y | 当前页行数 |
| list | Array | Y | 列表 |
| purchaseCode | String | Y | 申购代码 |
| purchaseName | String | Y | 申购名称 |
| beginNumber | String | N | 起始配号,当日申购记录为空 |
| numberCount | int | N | 配号数量,当日申购记录为空 |
| awardedCount | int | N | 中签数量,仅中签申购状态为中签时非空 |
| purchaseTime | String | Y | 申购时间 |
| purchaseState | int | Y | 申购状态,数据字典 |
| 值 | 说明 |
|---|---|
| 0 | 已申报 |
| 1 | 已配号 |
| 2 | 未中签 |
| 3 | 已中签 |
| 值 | 说明 |
|---|---|
| SH | 沪A |
| SZ | 深A |
| SZ_GEM | 创业板 |
| 值 | 说明 |
|---|---|
| 0 | 全部A股 |
| 1 | 上海 |
| 2 | 深圳(不含创业板) |
| 3 | 创业板 |