好彩头-接入平台接口协议_v2.0

《好彩头-接入平台接口协议_v2.0》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、全网电话投注接入平台协议深圳市好彩头网络科技有限公司状态√草稿标识号评审当前版本2.0修正版前一版本1.0修订版发布日期2014-02-20修改记录序号版本责任人时间修改内容记录1beta陈登峰2014-02-19第一次定稿1.术语和约定1.1概述1.2名词解释参数名称中文名称说明transcode交易代码交易代码代表着不同的交易接口业务msg交易数据Msg参数中各交易接口定义的交易数据消息体，由xml组key签名数字签名，由交易代码+交易数据+由好彩头分配的交易密匙进行md5得到的字符串，防止交互过程中被篡改partnerid

2、合作商ID由好彩头分配给合作商的代理标识号码1.通信方式1.1链接方式接入平台与合作商系统之间采用http的方式进行数据通信，交互协议中使用XML作为数据格式载体，对于对账开奖文件系统通过http协议数据流方式为合作商提供数据下载。由于接入商对安全的需求和业务不同，我们为要求安全较高的用户提供VPN连接，防止交互过程中用户信息泄漏；无论是使用vpn的用户还是非vpn的用户都需要进行数据交互的数字签名（MD5），防止数据交互过程中被篡改。1.2文件下载接入平台的对账，各合作商的中奖文件等各项业务文件，需要合作商通过http下载获得

3、，为保证数据安全，各类对账文件的下载地址为动态url地址，由合作商下载1.3参数在平台与合作商系统之间的数据交互中，请求参数都是用httppost方式进行发送，所有的交易接口都需要5个参数，transcode、msg、key、version和partnerid。参数名称中文名称说明transcode交易代码交易代码代表着不同的交易接口业务msg交易数据Msg参数中各交易接口定义的交易数据消息体，由xml组key签名数字签名，由交易代码+交易数据+由好彩头分配的交易密匙进行md5得到的字符串，防止交互过程中被篡改partnerid

4、合作商ID由好彩头分配给合作商的代理标识号码Version版本号协议版本，便于平台升级后对原有版本的支持返回参数在请求交易的会话中直接输出返回，返回参数也返回相应参数。参数以一下格式输出transcode=1001&msg=&key=7dfu38dsf0fdds89fdsafsa78qa7eu8&partnerid=100031&version=1.0。1.4异常平台的异常交易代码为000，当合作商收到交易返回结果的交易代码为000时，表示该交易出现异常，需

5、要代理商按照异常交易体的格式进行解析和做相应处理。1.5数据校验平台到合作商平台的数据交互过程中，无论是建立vpn连接还是未建立vpn连接的合作商都要对每次交互的数据进行校验，双方根据参数中trancode、msg和由好彩头分配给合作商的交易密匙进行md5（16位8-24）后与参数中的key进行对比，对比数据正确方为正确交易数据，双方的请求与应答都要进行MD5加密，以防止中间被第三方进行篡改。1.1约定编码格式：UTF-8详细时间格式：yyyymmddhhmmss时间格式：yyyymmdd金额字段：如果涉及小数保留小数点后两位大

6、小写：所有协议中的关键字均为小写1.2安全由于平台与合作商之间的数据传输通过公网实现，数据交易之间的安全我们通过如下几项措施实现：Ø访问控制：合作商接入时需向好彩头提供本方服务器的发送地址和回调地址，由好彩头开放其对平台服务器相应端口的访问权限。没有认证的服务器地址无法访问平台。Ø数字签名在所有的交易的发起和回执过程中的数据都经过了数据签名，通过交易数据明文加上由好彩头分配给合作商的密钥进行md5后生成，在交易过程中进行核对，方式传输过程中的篡改。ØVPN网络对于安全性要求较高的合作商，平台也提供vpn接入，在合作商与平台之间建

7、立vpn网络环境，从而达到整个的交易过程使用加密数据交互，防止明文数据外泄。1.3主动通知下发对于各种交易的最终交易结果,新期通知，开奖公告信息，统计信息等，系统会在交易成功后立即发送交易结果通知给合作商服务器，在合作商服务器返回接收到的信息后将不再发送，否则将重新发送一定次数后停止发送。1.4系统告警当平台的监控系统或者数据采集系统获得某个合作商的程序出现异常时或者合作商的资金系统到达告警额度后，系统会自动发送短信或者邮件告知合作商的负责人以提醒其系统的异常情况。2.消息结构所有通过交易接口传输的交易数据都按照约定的xml格式

8、进行编排，交易数据的格式主要由两部分组成，消息头和消息体组成，且该两部分为必备部分，只有按照该种格式的数据才会被系统接收处理。1.1描述：交易接口的消息体是平台和合作商间交互消息的主要信息载体，消息体分为两类常规交易消息体和异常消息体，正常交易消息体系统在正常状