- 全局返回码说明
- 获取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 |
凭证有效时间,单位:秒 |
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
|
请求参数说明
参数 |
是否必须 |
说明 |
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 |
是 |
启动游戏所带订单号,不参与签名 |
返回参数
接口获得通知正常情况下,应返回下述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
}