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

Posted 2020-10-22 lqsgame

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了网络推币机接口文档开发解决方案相关的知识，希望对你有一定的参考价值。

技术分享图片

全局返回码说明
获取accesstoken

接口调用说明

请求参数说明

返回说明

返回参数说明

获取在线设备列表

调用说明

请求参数说明

返回说明

返回参数说明

设置回调地址

调用说明

请求参数说明

返回说明

返回参数说明

启动游戏

调用说明

请求参数说明

返回说明

返回参数说明

2．游戏开始回调

调用说明

请求参数说明

返回参数说明

3．游戏结束回调

调用说明

请求参数说明

返回参数说明

4．出物回调

调用说明

请求参数说明

返回说明

返回参数说明

5．机器出错回调

调用说明

请求参数说明

返回参数说明

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

技术分享图片

全局返回码说明

0	请求成功
10001	无效的appid或者appsecret
10002	无效的accesstoken,或者accesstoken过期
10003	请求参数错误
10004	签名错误
10005	请求受限
10006	设备离线

获取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	凭证有效时间，单位：秒

２．获取在线设备列表

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

调用说明：

http:请求方式：get

http://{域名}：｛端口｝／getOnlineDevices?accessToken=ACCESS_TOKEN

请求参数说明

参数

是否必须

说明

Accesstoken

是

接口调用凭证

返回说明

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

｛ errcode:0,

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

}

返回参数说明

参数	说明
errcode	返回码
onlinedevices	在线设备数组，每一个元素代表一个设备ＩＤ

３．设置回调地址

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

回调重试机制：

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

通知频率这：５／１５／３０，单位：秒

调用说明：

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

}

游戏结束回调

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

调用说明

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

}

出币回调

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

调用说明

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	是	启动游戏所带订单号，不参与签名