网络推币机接口文档开发解决方案
- 全局返回码说明
- 获取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
|
请求参数说明
|
参数 |
是否必须 |
说明 |
|
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
|
请求参数说明
|
参数 |
是否必须 |
说明 |
|
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
|
请求参数说明
|
参数 |
是否必须 |
说明 |
|
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
|
请求参数说明：
|
参数 |
是否必须 |
说明 |
|
D |
是 |
设备唯一id |
|
T |
是 |
Unix时间戳 |
|
S |
是 |
签名，算法为sha256(d+t+appsecret)*d+t+appsecret为字符串拼接 |
返回参数
接口获得通知正常情况下，应返回下述json数据包：
{
errcode:0
}