网络推币机接口文档开发解决方案

时间:2024-01-23 14:21:17

  1. 全局返回码说明
  2. 获取accesstoken

接口调用说明

请求参数说明

返回说明

返回参数说明

  1. 获取在线设备列表

调用说明

请求参数说明

返回说明

返回参数说明

  1. 设置回调地址

调用说明

请求参数说明

返回说明

返回参数说明

  1. 启动游戏

调用说明

请求参数说明

返回说明

返回参数说明

 

2.游戏开始回调

调用说明

请求参数说明

返回参数说明

3.游戏结束回调

调用说明

请求参数说明

返回参数说明

4.出物回调

调用说明

请求参数说明

返回说明

返回参数说明

5.机器出错回调

调用说明

请求参数说明

返回参数说明

此文章描述了远程网龙其仕络推币机所使用的接口说明。

  1. 全局返回码说明

0

请求成功

10001

无效的appid或者appsecret

10002

无效的accesstoken,或者accesstoken过期

10003

请求参数错误

10004

签名错误

10005

请求受限

10006

设备离线

  1. 获取accesstoken

Accesstoken是推币机机控制全局唯一接口调用凭据,除此接口外,调用各个接口都需要使用accesstoken.accesstoken长度为40个字符,有效期是7200秒,需定时刷新,可重复获取,调用频次一天为2000次。

 

接口调用说明

 

http:请求方式:GET

http://{域名}:{端口}/accesstoken?appid=appid&appsecret=appsecret

 

请求参数说明

参数

是否必须

说明

Appid

第三方用户唯一凭证

Appsecret

第三方用户唯一凭证秘钥

返回说明

正常情况下,接口会返回下述json数据包:

{

Errcode:0

accessToken:"df745878f1d954268cb65f78e4078a8350312425",

  expiresIn: 7200

}

返回参数说明

参数

说明

Errcode

返回码,说明请查询返回码说明表

Accesstoken

获取到的凭证

Exporesln

凭证有效时间,单位:秒

 

2.获取在线设备列表

此接口获取在线的设备列表,方便判别设备网络连通状态。

调用说明:

http:请求方式:get

http://{域名}:{端口}/getOnlineDevices?accessToken=ACCESS_TOKEN

请求参数说明

参数

是否必须

说明

Accesstoken

接口调用凭证

返回说明

正常情况下,接口会返回下述json数据包

 { errcode:0,

  onlineDevices:["772366", "856302","882013"]

}

 

返回参数说明

参数

说明

errcode

返回码

onlinedevices

在线设备数组,每一个元素代表一个设备ID

3.设置回调地址

此接口设置3个设备状态回调地址,分别为游戏开始回调,游戏结束回调,出币回调。所设置的回调地址将设备状态发生变化是获得通知,通知接口详细说明,请看具体接口描述。

回调重试机制:

对设置的回调地址请求时,如果收到应答不是成功或请求超时,认为通知失败会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。

通知频率这:5/15/30,单位:秒

 

调用说明:

http请求方式:post

http://{域名}:{端口}/setCallBack?accessToken=ACCESS_TOKEN

POST Form Data\

 

gameStartCallBackAddr=http://xxx.xxx.com/xxx gameEndCallBackAddr=http://xxx.xxx.com/xxx giftCallBackAddr=http://xxx.xxx.com/xxx errorCallBackAddr=http://xxx.xxx.com/xxx

 

请求参数说明

参数

是否必须

说明

Accesstoken

接口调用凭证

Gamestartcallbackaddr

游戏开始回调地址

Gameendcallbackaddr

游戏结束回调地址

Giftcallbackaddr

出币回调地址

Errorcallbackaddr

机器出错回调地址

返回参数

正常情况下,接口会返回下述json数据包:

{

Errcode:0

}

返回参数说明

参数

说明

Errcode

返回码

4.启动游戏

此接口控制设备启动游戏。

调用说明

http:请求方式:post

http://{域名}:{端口}/startgame/accesstoken=access_token

post form date:

deviceId=772366
gstrength=50
lstrength=23
tradeNo=xxxxxx
gameTime=30

 

请求参数说明

参数

是否必须

说明

Accesstoken

接口调用凭证

Gstrength

本局游戏最高投币量

Lstrength

本局游戏最低币量

Deviceld

指定设备ID

Tradeno

启动订单号(如设备此项,游戏开始,结束,出币回调中会携带此订单号)

Gametime

自动投币等待时间(如不调协此项,默认时间为30秒)

返回参数

正常情况下,接口会返回下述json数据包

{

  errcode:0

}

 

返回参数说明

参数

说明

Errcode

返回码

 

5.游戏开始回调

当设备启动游戏时,由此接口获得通知,用户需要实现此接口以获得通知

调用说明

http请求方式:get

接口地址为*设置回调接口*填写的gamestartcallbackaddr地址

Get query date:

d=772366&t=1498548057&s=e56d336922eaab3be8c1244dbaa713e134a8eba50ddbd4f50fd2fe 18d72595cd&tn=xxxxx

 

请求参数说明

参数

是否必须

说明

D

设备唯一ID

T

UNIX时间戳

S

签名,算法为sha256(d+T+appsecret)*注d+T+appsecret为字符串拼接

tn

启动游戏所带订单号,不参与签名

返回参数

接口获得通知正常情况下,应返回下述json数据包:

{

Errcode:0

}

  1. 游戏结束回调

当设备结束游戏时,由此接口获得通知,用户需要实现此接口以获得通知。

调用说明

http请求方式: get

接口地址为*设置回调接口*填写的gameendcallbackaddr地址

Get query data:

d=772366&t=1498548057&s=e56d336922eaab3be8c1244dbaa713e134a8eba50ddbd4f50fd2fe 18d72595cd&tn=xxxxx

请求参数说明

参数

是否必须

说明

D

设备唯一ID

T

UNIX时间戳

S

签名,算法为sha256(d+t+appsecret)*d+t+appsecret为字符串拼接

TN

启动游戏所带订单号,不参与签名

返回参数

接口获得通知正常情况下,应返回下述json数据包:

{

Errcode:0

}

  1. 出币回调

当设备游戏过程中有出币时,由此接口获得通知,用户需要实现此接口以获得通知。

调用说明

http请求方式:get

接口地址为*设置回调接口*填写的giftcallbackaddr地址

Get query data

d=772366&t=1498548057&s=e56d336922eaab3be8c1244dbaa713e134a8eba50ddbd4f50fd2fe 18d72595cd&tn=xxxxx

 

请求参数说明

参数

是否必须

说明

D

设备唯一id

T

Unix时间戳

S

签名,算法为sha256(d+t+appsecret)*d+t+appsecret为字符串拼接

TN

启动游戏所带订单号,不参与签名

返回参数

接口获得通知正常情况下,应返回下述json数据包:

{

  errcode:0

}

9.机器出错回调

当设备出错时,由此接口获得通知,用户需要实现此接口以获得通知。

调用说明

http请求方式:get

接口地址为*设置回调接口*填写的gamestartcallbackaddr地址

Get query date:

d=772366&t=1498548057&s=e56d336922eaab3be8c1244dbaa713e134a8eba50ddbd4f50fd2fe 18d72595cd

 

请求参数说明:

参数

是否必须

说明

D

设备唯一id

T

Unix时间戳

S

签名,算法为sha256(d+t+appsecret)*d+t+appsecret为字符串拼接

返回参数

接口获得通知正常情况下,应返回下述json数据包:

{

  errcode:0

}