《好彩头-接入平台接口协议_v2.0概要》由会员分享，可在线阅读，更多相关《好彩头-接入平台接口协议_v2.0概要（61页珍藏版）》请在金锄头文库上搜索。
1、 全网电话投注接入平台协议 深圳市好彩头网络科技有限公司状态草稿标识号评审当前版本2.0修正版前一版本1.0修订版发布日期2014-02-20修改记录序号版本责任人时间修改内容记录1beta陈登峰2014-02-19第一次定稿1. 术语和约定1.1 概述1.2 名词解释参数名称中文名称说明transcode交易代码交易代码代表着不同的交易接口业务msg交易数据Msg参数中各交易接口定义的交易数据消息体，由xml组key签名数字签名，由交易代码+交易数据+由好彩头分配的交易密匙进行md5得到的字符串，防止交互过程中被篡改partnerid合作商ID由好彩头分配给合作商的代理标识号码2. 通信方式
2、2.1 链接方式接入平台与合作商系统之间采用http的方式进行数据通信，交互协议中使用XML作为数据格式载体，对于对账开奖文件系统通过http协议数据流方式为合作商提供数据下载。由于接入商对安全的需求和业务不同，我们为要求安全较高的用户提供VPN连接，防止交互过程中用户信息泄漏；无论是使用vpn的用户还是非vpn的用户都需要进行数据交互的数字签名（MD5），防止数据交互过程中被篡改。2.2 文件下载 接入平台的对账，各合作商的中奖文件等各项业务文件，需要合作商通过http下载获得，为保证数据安全，各类对账文件的下载地址为动态url地址，由合作商下载2.3 参数 在平台与合作商系统之间的数据交互
3、中，请求参数都是用http post方式进行发送，所有的交易接口都需要5个参数，transcode、msg、key、version和partnerid。 参数名称中文名称说明transcode交易代码交易代码代表着不同的交易接口业务msg交易数据Msg参数中各交易接口定义的交易数据消息体，由xml组key签名数字签名，由交易代码+交易数据+由好彩头分配的交易密匙进行md5得到的字符串，防止交互过程中被篡改partnerid合作商ID由好彩头分配给合作商的代理标识号码Version版本号协议版本，便于平台升级后对原有版本的支持返回参数在请求交易的会话中直接输出返回，返回参数也返回相应参数。参数以
4、一下格式输出transcode=1001&msg=&key=7dfu38dsf0fdds89fdsafsa78qa7eu8&partnerid=100031&version=1.0。2.4 异常 平台的异常交易代码为000，当合作商收到交易返回结果的交易代码为000时，表示该交易出现异常，需要代理商按照异常交易体的格式进行解析和做相应处理。2.5 数据校验 平台到合作商平台的数据交互过程中，无论是建立vpn连接还是未建立vpn连接的合作商都要对每次交互的数据进行校验，双方根据参数中trancode、msg和由好彩头分配给合作商的交易密匙进行md5（16位8-24）后与参数中的key进行对比，对
5、比数据正确方为正确交易数据，双方的请求与应答都要进行MD5加密，以防止中间被第三方进行篡改。2.6 约定 编码格式：UTF-8 详细时间格式：yyyymmddhhmmss 时间格式：yyyymmdd 金额字段：如果涉及小数保留小数点后两位 大小写：所有协议中的关键字均为小写2.7 安全由于平台与合作商之间的数据传输通过公网实现，数据交易之间的安全我们通过如下几项措施实现： 访问控制：合作商接入时需向好彩头提供本方服务器的发送地址和回调地址，由好彩头开放其对平台服务器相应端口的访问权限。没有认证的服务器地址无法访问平台。 数字签名在所有的交易的发起和回执过程中的数据都经过了数据签名，通过交易数据
6、明文加上由好彩头分配给合作商的密钥进行md5后生成，在交易过程中进行核对，方式传输过程中的篡改。 VPN网络对于安全性要求较高的合作商，平台也提供vpn接入，在合作商与平台之间建立vpn网络环境，从而达到整个的交易过程使用加密数据交互，防止明文数据外泄。2.8 主动通知下发对于各种交易的最终交易结果,新期通知，开奖公告信息，统计信息等，系统会在交易成功后立即发送交易结果通知给合作商服务器，在合作商服务器返回接收到的信息后将不再发送，否则将重新发送一定次数后停止发送。2.9 系统告警当平台的监控系统或者数据采集系统获得某个合作商的程序出现异常时或者合作商的资金系统到达告警额度后，系统会自动发送短
7、信或者邮件告知合作商的负责人以提醒其系统的异常情况。3. 消息结构所有通过交易接口传输的交易数据都按照约定的xml格式进行编排，交易数据的格式主要由两部分组成，消息头和消息体组成，且该两部分为必备部分，只有按照该种格式的数据才会被系统接收处理。3.1 描述：交易接口的消息体是平台和合作商间交互消息的主要信息载体，消息体分为两类常规交易消息体和异常消息体，正常交易消息体系统在正常状态下的数据交互消息格式，异常消息体是指系统在发生异常时返回的消息体，且所有的异常消息都具有相同的格式和交易代码。3.2 消息头结构消息头为消息的公共信息部分，该部分的信息主要为身份、时间、类型标识的数据集合。格式如下
8、字段名称中文名称说明transcode交易代码由服务方指定，服务器方会根据交易码进行请求处理 （不能为空）partnerid合作商ID由好彩头分配pwd全作商密码由好彩头分配time该数据创建的时间在合作商系统中创建该数据时的系统时间version协议版本协议版本，便于平台升级后对原有版本的支持3.3 消息体结构 消息体中为每次交易的交易核心数据体，每个交易接口本文档都将给出相应的交易体接口和字段说明。交易体接口如下： 3.4 错误体结构 异常消息体上在合作商发送请求后，系统出现异常返回的异常信息格式体，无论请求的业务为什么业务，返回的异常消息体格式如下： 000 20090305102259
9、 2.0 4. 交易代码4.1 编码规则交易代码由三个数字组成，第一位数字为交易类型区分位，后两位为交易内容区分位 字段名称说明1由合作商发起的请求接入平台代码类6平台对合作商发起请求的回应，同时该类信息还主动由平台向合作平台通知的信息。如期统计信息，开奖公告信息，平台会主动发送该类信息通知给合作商平台，同时查询该类信息的接口上也返回的相同的信息。7平台对合作商发起请求的回应，与6不同在于该类信息只做请求响应。4.2 交易代码列表 平台的交易代码如下：交易代码中文名称说明101期查询接口101为期查询接口，不添加期号参数时为当前期111期汇总查询接口111 查询期汇总信息112开奖公告查询接口
10、112 查询开奖公告信息130查询游戏列表130 如果期次为空查询当前期游戏列表131查询游戏SP值132 查询游戏SP值132获取场次结果133 获取某场游戏的结果133查询某场游戏SP值接口133 查询某场游戏SP值134竞彩游戏单关奖金查询接口134 查询竞彩游戏单关奖金 104投注接口104为彩票投注接口，该接口只支持各彩种的直投订单 701期查询返回701 返回期查询结果 704投注接收返回结果作为201的返回信息，告知订单验证与接收结果，并返回各个订单的平台ID。该结果只表示订单接收成功，并不保证出票成功。 105交易结果查询105为查询订单的结果信息 605交易结果通知605接口
11、为交易结果通知，该接口通知为彩票的最终交易结果。105的查询也返回同样格式的数据。 109合作商账户查询接口109接口查询合作商当前资金数据110结场汇总查询接口110 返回结场汇总信息 709返回合作商的资金返回合作商的账户余额710返回结场汇总查询710 返回结场汇总信息711期汇总返回711 返回期汇总信息712开奖公告查询返回接口712 返回开奖公告奖级信息和销量信息730游戏列表查询返回接口730 返回游戏列表查询结果731期次SP值查询返回接口731 返回期次SP值查询结果732获取游戏赛果返回接口732 返回游戏赛果733查询某场游戏SP值返回733 返回某场游戏SP值734竞彩
12、游戏单关奖金返回734 返回竞彩游戏单关奖金5. SP顺序列表5.1 SP需要调整 顺序列表-竞彩 彩种名字SP选项顺序竞彩足球比分 FTBF10 20 21 30 31 32 40 41 42 50 51 52 90 00 11 22 33 99 01 02 12 03 13 23 04 14 24 05 15 25 09竞彩足球胜平负（非让球） FTBRQSPF3 1 0 （3 胜 1 平 0 负） 竞彩足球让球胜平负（让球） FTSPF3 1 0 （3 胜 1 平 0 负）竞彩足球总进球 FTJQS0 1 2 3 4 5 6 7竞彩足球半全场 FTBQC33 31 30 13 11 10 0301 00竞彩篮球胜负 BSKSF1 2 竞彩篮球大小分 BSKRFSF1 2 竞彩篮球让分胜负 BSKDXF1 2竞彩篮球胜分差 BSKSFC01 02 03 04 05 06 11 12 13 14 15 16 5.2 SP 顺序列表-北京单场 彩种名字SP选项顺序足球比分 BF1:0 2:0 2:1 3:0 3:1 3:2 4:0 4:1 4:2 A 0:0 1:1 2:2 3:3 B 0:1 0:2 1:2 0:3
