行情网关服务接入说明v

《行情网关服务接入说明v》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、金证行情网关接口说明金证行情网关接入说明V1.0(2015-05-03)公司名称金证股份文档编号APIHQGW_20150505文档名称金证行情网关接入说明文档版本1.0起草罗时俊起草日期20150503审批审批日期金证行情网关接口说明修订历史版本号日期状态修订人摘要V1.02015/05/03C罗时俊创建状态标识：C–CreatedA-AddedM-ModifiedD-Deleted金证行情网关接口说明目录目录3一、金证行情网关介绍4二、通讯说明4三、协议说明5标准消息头字段51.1.1登录请求(MsgType=L

2、ogon)51.1.2登录应答(MsgType=Logon)61.1.3注销请求(MsgType=Logout)61.1.4注销应答(MsgType=Logout)61.1.5心跳包请求(MsgType=Heartbeat)61.1.6心跳包应答(MsgType=Heartbeat)61.1.7消息拒绝(MsgType=Reject)71.1.8通知推送(MsgType=News)71.1.9行情请求订阅(MsgType=MarketDataRequest)71.1.10行情请求推送(MsgType=MarketDa

3、taSnapshotFullRefresh)7交易所实时行情报文8金证行情网关接口说明第一章系统介绍一、金证行情网关介绍实现所有业务系统行情的统一管理二、通讯说明每个客户端与行情服务器建立一个TCP连接通讯使用异步模式连接后必须进行登录,登录完成以后才允许进行业务交互。登录成功后会分配一个tick，以后每个业务必须带回报文由包头+包体组成包头固定长度为20，由长度信息(12)+校验信息(8)两部分组成金证行情网关接口说明长度信息(12)由”len=”开头，后跟8位的包体长度字符串，不足补“0”校验信息(8)对包体报文

4、的checksum，暂时不用，固定送”00000000”包体是实现业务的json格式字符串一个合法报文示例：len=0000001400000000{"name"="123"}一、协议说明每一个业务消息都是由json串组成，其中包含标准消息头字段和业务字段标准消息头字段字段名称字段说明必送注释BeginString版本号Y固定为KDLINK.1.0.0MsgType消息类型YSenderCompID发送者IDY发送者IDTargetCompID接收者IDY接收者IDMsgSeqNum会话序号Y会话序号，必须连续递增S

5、endingTime发送时间Y发送时间,格式:2015-05-0508:36:07.660Tick票据Y登录成功后返回，以后每个业务必送(注：必送字段中Y表示必送，N表示不送，C表示按条件。下同)121.1.1登录请求(MsgType=Logon)登录消息是在会话开始时，连接双方发送的第一个消息。登录消息总是成对出现，接收方在接收登录消息时，将验证发起方身份的合法性，并且同样发出登录消息给发送方以确认连接请求已被接受。业务字段字段名称字段说明必送注释<标准消息头>YEncryptMethod安全认证方式Y暂不支持“0

6、”:不加密“1”:DES“200”:证书Password用户密码Y用户密码的MD5签名金证行情网关接口说明HeartBtInt心跳间隔，秒为单位Y客户端心跳间隔，当连接空闲时，服务端定时检查连接的心跳消息，超过此心跳间隔+5的连接将被踢掉。1.1.1登录应答(MsgType=Logon)字段名称字段说明必送注释<标准消息头>YTick认证票据Y安全认证通过以后传回的安全令牌，以后每笔业务必送1.1.2注销请求(MsgType=Logout)注销消息是发起或确认会话终止的消息。未经注销消息交换而断开连接，一律视为非正常

7、的断开。字段名称字段说明必送注释<标准消息头>YText注销原因C随便填，日志系统记录1.1.3注销应答(MsgType=Logout)字段名称字段说明必送注释<标准消息头>Y1.1.4心跳包请求(MsgType=Heartbeat)字段名称字段说明必送注释<标准消息头>Y1.1.5心跳包应答(MsgType=Heartbeat)字段名称字段说明必送注释<标准消息头>Y1.1.6消息拒绝(MsgType=Reject)字段名称字段说明必送注释金证行情网关接口说明<标准消息头>YRefSeqNum被拒消息序号YReje

8、ctReason拒绝原因Y1.1.1通知推送(MsgType=News)字段名称字段说明必送注释<标准消息头>YHeadline标题Y通知消息的主题，可包括:Exchange,brokerText正文YGBK编码1.1.2行情请求订阅(MsgType=MarketDataRequest)字段名称字段说明必送注释<标准消息头>YSubscript