atitit.恒朋无纸化彩票系统数据接入通信协议 – weixin_33735676的博客

 atitit.恒朋无纸化彩票系统数据接入通信协议 

深圳恒鹏科技发展有限公司

  Shenzhen Helper Science & Technology Co., Ltd. 

     恒朋无纸化彩票系统数据接入通信协议 

文档版本历史 

内容目录

恒朋无纸化彩票系统数据接入通信协议……………………………………..1 

文档版本历史…………………………………………………………2 

内容目录…………………………………………………………….3 

1.文档定义…………………………………………………………..4 

名词和缩略语………………………………………………….4 

文件惯例……………………………………………………….4 

2.概述………………………………………………………………5 

角色定义……………………………………………………….5 

事务交互过程……………………………………………………5 

3. 事务消息定义………………………………………………………6 

 http参数………………………………………………………6 

消息包…………………………………………………………6 

消息头…………………………………………………………8 

消息体………………………………………………………..11 

.1奖励期通知…………………………………………………..11 

.2奖励搜索…………………………………………………..12 

.3投注………………………………………………………14 

.4投注结果通知……………………………………………….17 

.5票查询…………………………………………………….19 

.6报酬回报调查…………………………………………………..21 

.7销量查询…………………………………………………..22 

4总述………………………………………………………………24 

附录A 玩法参数说明…………………………………………………..25 

附录B 响应状态码说明…………………………………………………26 

附录C 投注号码格式说明……………………………………………….28 

附录D 玩法奖等参数说明……………………………………………….32 

1.文档定义 

第三方投注代理商如果要实现接入恒朋无纸化彩票系统,需要引用两个文档。,一份是《恒朋无纸化彩票系统数据接入技术方案》,以及当前的这份《恒朋无纸化彩票系统数据接入通信协议》。《恒朋无纸化彩票系统数据接入技术方案 》说明了第三方投注代理商与恒朋无纸化彩票系统的连接与通信的技术方案,《恒朋无纸化彩票系统数据接入通信协议》说明了通信的数据结构。两份文件的所有权归属于深圳恒鹏科技有限公司。。 

名词和缩略语 

MD5 

HTTP 

XML 

SCHEMA 

文件惯例 

 文档注释部分将被使用。10号字体,并将指示: 

 文档的当前版本将相对以前的VE使用。蓝色字体显示。 

2.概述 

恒朋无纸化彩票系统可以接入多个第三方投注代理商,为第三方投注代理提供数据登陆服务。,同时,为第三方投注代理商实现彩票。 

注:更多信息可以参考《恒朋无纸化彩票系统数据接入技术方案》 

角色定义 

 投注代理:也可以叫做第三方投注代理商,它提供了用户界面。,接收用户对投注的请求,管理用户投资基金,返奖。 

 恒朋无纸化彩票系统 :从投注代理接收赌注数据,完成裁决,为投注代理商提供数据登陆服务。 

事务交互过程  

在第三方投注代理商与恒朋无纸化彩票系统之间的交互过程中,第三方投注代理发起该请求。,也有恒朋无纸化彩票系统主动发起请求。当任何一方提出请求时,发起请求的一方是请求方。,收到请求的一方是被告。。下图说明了第三方投注代理商与恒朋无纸化彩票系统之间的交互过程:

当前恒朋无纸化彩票系统默认支持的数据传输协议为HTTP,所以每一次互动都是一种要求。/响应的模式。发送方发送请求后,等待响应,和过程响应信息。。 

3. 事务消息定义 

 http参数 

事务交互是以HTTP协议为基础的数据传输协议。,事务请求的结束被定义为客户端。,客户端需要在HTTP POST模式下提交事务请求。,在事务请求中,需要定义两个参数。: 

参数名 

参数说明 

交易类型, 参考 消息头事务类型定义的一部分,例如103

事务包

让我们假设有一个奖励周期查询的事务请求。,然后HTTP消息正文的内容如下: 

transType=102&transMessage=

 38991220070510092433101 8123f913e123e123990028d9c72e013c

    

注:实际http传输中,内容的可能编码。 

消息包 

每一个要求/响应的消息包都是一个。xml的字符串,包含消息标题和消息正文。,对于不同类型的请求/反应(如博彩和奖励期),消息标题的格式是相同的。,该消息带有特定类型的请求。/响应信息。 

请参考以下消息包格式定义。 

[消息包示例1裁决通知请求]      

             

   

          

 

    

 

        389912 

[消息头] 20070510092435 

        501 

        8123f913e123e123990028d9c72e0dfgds 

    

 

     

 [消息体         成功,系统处理正常“/> 

     

 

[消息包示例2奖励通知响应

整个消息包是一个。xml字串,第一语句xml版本与编码,这里定义encodingGBK。消息包元素message在声明中versionid两个性质,其中: 

 version 表示Masag所使用的数据通信协议的版本。,目前用于 

 id 表示事务分组的数目。,这个编号必须保证在恒朋无纸化彩票系统唯一。对于同一交易,请求/响应的消息id应该是一样的。。数字的生成规则是agentID+8位时间戳(YYYYMMD) 8位增量流编码,其中: 

 agentID是恒朋无纸化彩票系统为第三方投注代理商分配的唯一编号。 

 增量流代码1开始到99999999,每次递增1,  到达99999999然后从1开始,由投注经纪人管理,不足8左位补码0 

例如,一个数字是389912代理2007510一个颁奖日期的请求被启动了。, 然后请求的消息包id3899122007051000000231,增量流水线编号是231 

消息头和消息体的描述,请参阅后续章节。。 

注: 在本文档的示例部分中,我们总是假设投注代理的数量是389912。 

消息头 

所有事务请求和每个事务的请求的消息头/响应具有相同的数据结构。,其中包含的信息描述消息包的发送者。,信息传递时间,事务请求的类型和M的部分信息摘要。 

注:消息标题的结构不再在描述中重复。。 

    

 

        389912 

        200703510102433 

        101 

        8123f913e123e123990028d9c72e013c 

    

 

header元素定义消息头的数据结构。,其中: 

名称 

数据类型 

必需 

长度 

描述 

[消息标题]

交易类型。每个事务包括请求和响应。,目前,支持以下类型的事务。: 

 时间戳: 也就是说,在页眉中timestamp元素的值。 

 投注代理代码:恒朋无纸化彩票系统会为每个投注代理商分配一个访问密码,此密码不会直接在消息中传输。。无论是投注代理商向恒朋无纸化彩票系统发送消息还是恒朋无纸化彩票系统向某个代理发送消息,他们将使用投注代理的密码来执行摘要。。 

 消息体: 消息包中body单元部分。 

假设请求消息如下: 

 

 

    

 

        389912 

        20070510102433 

        102 

        8123f913e123e123990028d9c72e013c 

    

 

     

         

   

         

     

 

那么,抽象的字符串应该是(假设投注A的密码)111111): 

389912200705101234567820070510102433111111  

注:被摘要的body单元部分应该保留消息字串中的所有格式信息,例如,空白空间。 

同时,查询请求的响应消息应该是: 

 

 

    

 

        389912 

        20070510102440 

       502 

        8123f913e123e123990028d9c72e013c 

    

 

     

        成功,系统处理正常“> 

           

  status=”5″ bonusCode=”1,2,3,4,5″/> 

         

     

 

[样本请求]

[示例响应]

请参阅后续章节以说明奖项的每一个。 

消息体 

在投注代理商和恒朋无纸化彩票系统之间有多个不同的业务交互,每个交互需要发送特定的业务请求。,恒朋无纸化彩票系统根据或者投注代理商根据不同的业务请求来执行相应的业务处理。每一个业务流程都是一个要求。/响应过程,也就是说,每个业务请求都会有相应的业务响应。。 

.1奖励期通知 

当恒朋无纸化彩票系统的奖期状态转换的时候,例如,开始一个新的奖励期,结束奖期等。,恒朋无纸化彩票系统会向相应的投注代理商系统发送奖励期通知,通知投注代理人更改授奖期限。同时投注代理商也可以不依赖于恒朋无纸化彩票系统的奖励期通知机制,您可以通过服务的方式获得奖励期限的状态转换。。当然投注代理商也可以完全不依赖于恒朋无纸化彩票系统的奖期管理,由你来管理颁奖期。。 

1)恒朋无纸化彩票系统向投注代理商发出奖励期通知的请求消息,消息正文格式如下: 

 

          

   

  status=”1″ /> 

 

  status=”1″ /> 

       

     

消息体元素body定义在issueNotify子元素来声明奖励期通知,其中: 

* issueNotify元素: 容器元素,定义了奖励期通知数据结构。 

 issue元素:奖励期要素,描述获奖日期信息。。 

名称 

数据类型

必需 

长度 

描述 

gameName  

string  

Y  

*  

播放次数,游戏号码的具体定义可参考Appendix B.。 

[请求消息体]

长度 

描述 

code  

string  

Y  

4  

响应请求处理的响应状态代码,具体的定义可以参见附录B。。 

message 

注:响应消息包含response子元素,在所有事务响应信息中,该元素的结构相同。,因此,这个元素将不再被重复。。 

    

[响应消息体]

其中,issueQuery元素定义了奖励查询请求的数据结构。,issue子元素描述要查询的奖励期。。如果未指定issue元素的number属性,然后默认返回以播放当前奖励期的信息。,并且当前的奖励周期编号将包含在响应信息中。,更多关于issue元素描述可以指随后的奖励响应部分。issue的描述 

2) 恒朋无纸化彩票系统向投注代理商返回响应信息,消息正文格式如下: 

   

 成功,系统处理正常” > 

    

     number=”2007051002″  

     startTime=”20070328080000″ 

                                  stopTime=”20070328180000″ 

     status=”5″ 

     bonusCode=”1,2,3,4,5″/> 

    

     

响应消息,issue元素描述了详细的奖励信息。。 

* issue元素 

名称 

数据类型 

必需 

长度

描述 

gameName  

string  

Y  

*  

播放次数,游戏号码的具体定义可参考Appendix B.。 

number  

string  

Y  

*  

颁奖期开放时间,格式与消息头中的时间戳子元素相同。, 为yyyyMMddHHmmss,示例: 20070510080000表示2007510日上午800 

奖励截止日期,格式startTime 

玩法的状态,可选值可以参照”奖励期通知”部分对于”event”子元素的code 属性的描述。 

奖期的彩票号码。 

[响应消息体]

恒朋无纸化彩票系统状态 

暂停奖期 

完成期结 

issue, startTime, stopTime, status 

完成兑奖 

issue, startTime, stopTime,  bonusNumber, status 

 

[异常响应消息体]

  

       

      

  

        

     cardNumber=”430525800815722″ 

     mobile=”13612736754″ 

    realName=”王以智” bonusPhone=” (0755)65079323″ /> 

    1,2,3,4,5 

    5,6,3,2,1 

      

     

    playType=”301″ money=”” amount=”1″> 

             

    cardNumber=”G03355390″  

    bonusPhone=” (023)76526753″ 

    mobile=”13098191231″ realName=”李侠“/> 

    _,_,9,7,8 

    _,_,3,6,5 

    _,_,2,7,6 

      

       

      

彩票投注的基本单位是彩票。,它对应于投注请求消息的主体之一。ticket元素,每个投票只能包含相同的投注号码。,对投注号码的数量有限制。,具体定义可以参照下表。playType属性的定义。 

在请求消息正文中的下注。,lotteryRequest是容器元素,它可以有不止一个。ticket子元素,这表示恒朋无纸化彩票系统可以处理投注代理商的批量投注请求,当前协议版本定义了可以携带的投注请求。500票。 

下面对消息体的数据结构进行说明。: 

 [请求消息体]

 ticket元素:赌票 

名称 

数据类型 

必需 

长度 

描述 

id  

string  

Y  

22  

票号,生成规则可以参照消息包的id 定义规则。 

playType  

integer 

Y  

投注法,当前支持以下投注法定义: 

方式编号

5组投注号码

103 

cardType 

方式编号 

军官证 

护照 

长度

  

1)恒朋无纸化彩票系统向投注代理商发起投注结果通知交易请求,消息正文格式如下 

[响应消息体]

      <ticket id=”3899122007051000000231″ 

        

      

其中,响应消息中的ticketNotify定义了博彩结果通知消息体的结构。,ticket子元素和相应的投注事务请求ticket元素是对应的。,也就是说,投注交易中的每一个请求。ticket投注的结果将在相应的投注通知中返回。,其中: 

 ticket: 投注基本单位 

名称 

数据类型 

必需 

长度

描述 

dealTime  

string  

Y  

14  

恒朋无纸化彩票系统处理投注代理投注请求的时间,格式是YYYYMDDHHMMSS。。 

status  

string  

Y  

4  

恒朋无纸化彩票系统处理某一票投注的状态,状态代码可以参考附录B。

message 

string 

如果恒朋无纸化彩票系统处理票赌博失败,能解释失败的原因。。 

2)投注代理商返回相应信息到恒朋无纸化彩票系统,消息正文格式如下: 

  

      0000 message=”成功,系统处理正常“/> 

  

[请求消息体]

[响应消息体]

    

2)恒朋无纸化彩票系统处理了投注代理商的票查询请求,返回响应信息。消息体格式,如 

[请求消息体]

[响应消息体]

         

  成功,系统处理正常“> 

          

        

    dealTime=”20070510165423″ money=””    

    playType=”301″  amount=”2″ 

    status=”0000″ message=” “/> 

                            

          wang@”  

cardNumber=”430525800815722” mobile=”13612736754″  

realName=”王以智” bonusPhone=”(0755)65079323″/> 

          1,2,3,4,5 

          5,2,3,6,7 

    

        

    dealTime=”20070510165423″ money=”” 

    playType=”301″ amount=”1″ 

    status=”0000″ message=””/> 

                           ssc” number=”2007051001″ /> 

               

     mail=”ramon@” 

     cardNumber=”G03355390″ 

     bonusPhone=”(023)76526753″ 

     mobile=”13098191231″ realName=”李侠“/> 

          1,9,7,8,2 

          2,9,3,6,1 

          8,2,7,6,3 

                       

    

   

      

ticketQueryResult元素定义了票证查询结果的数据结构。,其中的ticket子元素与请求Req中的票证数据结构类似。,不要在这里重复它们。,请参照投注部分。 

.6报酬回报调查 

投注代理商向恒朋无纸化彩票系统发起返奖的请求,恒朋无纸化彩票系统处理请求,然后将奖励数据返回给投注代理。。 

1)投注代理商向恒朋无纸化彩票系统发起返奖请求,消息正文格式如下: 

[请求消息体] 

   

    

                              

            

 

bonusQuery元素定义请求请求的数据结构。,issue元素描述了要查询的奖期的信息,关于issue描述可以参考。奖励搜索部分。 

2)恒朋无纸化彩票系统接收到投注代理商的请求,处理请求后,返回奖励数据。消息正文格式如下: 

  [响应消息体]        

 

   成功,系统处理正常“> 

     

    totalItems=”3″ totalMoney=””> 

                 

    

   bonusLevel=”1″ ticketID=”3899122007051045451212″/> 

   

   bonusLevel=”2″ ticketID=”3899122007051045451212″/> 

   

   bonusLevel=”3″ ticketID=”3899122007051098127477″/> 

      

    

  

在响应信息的消息体中,bonusQueryResult定义了返回信息的数据结构。,其中: 

 bonusQueryResult元素 

名称 

数据类型 

必需 

长度 

描述 

bonusNumber 

string  

Y  

*  

彩票号码。 

totalItems  

integer  

Y  

获奖记录总数。 

totalMoney  

double  

Y  

中奖金额总数。 

* issue :描述获奖日期信息。,可以参照奖励搜索中关于issue的定义。 

* bonusItem元素返奖明细 

名称 

数据类型 

必需 

长度 

描述 

playType  

isBombBonus  

money  

bonusLevel  

ticketID 

string 

.7销量查询 

      

[请求消息体]

[响应消息体]

                      

balanceQueryResult元素定义了销量查询结果的数据结构,其中: 

名称 

数据类型 

必需 

长度 

描述 

salesMoney  

double  

Y  

该奖期的销售金额。只有奖期截止之后才能查询到销售金额。

bonusMoney  

double  

Y  

该奖期的返奖金额。只有返奖之后才能查询到返奖金额。返奖之前查到的返奖金额为-1 

* issue :描述获奖日期信息。,可以参照奖励搜索中关于issue的定义。 

如果恒朋无纸化彩票系统处理销量查询请求出现异常,那么返回信息的消息正文格式如下: 

           

      系统未知异常“/> 

   

其中responsecode属性定义了响应状态码,可以参照附录B

[响应消息体]

[响应消息体]

4总述 

在这份通信协议中,主要描述了投注代理商与恒朋无纸化彩票系统之间的通信数据结构,概述部分简要的介绍了投注代理商与恒朋无纸化彩票系统之间的交互过程,如果要了解更多,可以参考《恒朋无纸化彩票系统数据接入技术方案》。 

附录玩法参数说明 

玩法名称 

区域 

全国 

20

重庆 

205 

附录响应状态码说明 

0000 

0010 

报文格式错误。 

0011 

不支持协议版本,例如,设置。messageversion属性为 

0012 

messageID格式错误。 

0014 

timestamp错误的时间戳格式。 

0015 

消息摘要错配。 

0016 

不支持事务类型。。 

0017 

MessageId重复。 

0098 

单个请求超过最大并发。。 

1011 

1012 

1013 

奖励期。 

2001 

用户手机号码错误。 

2012 

2013 

2014 

2015 

禁止团体投票。 

2045 

2046 

2047 

重复发送的投注票(该投注票已经发送到恒朋无纸化彩票系统了)。 

票号不存在。。 

赌博失败。 

投注中。 

3001 

3002 

3003 

9999 

投注法 

时时彩 

数字用逗号分隔。,示例:1,2,3,4,5  

说明 

{5个号码

2号码下划线。_表示,数字用逗号分隔。

3号码下划线。_表示,数字用逗号分隔。

{5个号码

支票中只有五颗星。、三星与双星支票 

格式 

五星级支票

数字用逗号分隔。。 

三星与价值 

{5个号码

投注法 

投注法 

投注法 

投注法 

格式和直接选举赌注。 

单赌 

投注法 

投注法 

说明 

奖项及其他定义

二等奖 

选择6个红球号码

N 

N 

N 

二等奖 

选中3个基本号 

发表评论

电子邮件地址不会被公开。 必填项已用*标注