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

lqsgame lqsgame     2022-10-12     239

关键词:

技术分享图片

  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

}

 





webapi文档描述-swagger

...项目使用mvc+webapi,采取前后端分离的方式,后台提供API接口给前端开发人员。这个过程中遇到一个问题后台开发人员怎么提供接口说明文档给前端开发人员,最初打算使用word文档方式进行交流,实际操作中却很少动手去写。为了... 查看详情

优雅解决typescript生成接口文档的问题

写在前面的我这个人平时比较懒,尤其不是很喜欢写接口文档,在前后端开发的过程中这个需求总是存在的。虽目前主营前端,但是工作室后端的事情也经常是我在管的,所以如何更好的偷懒呢?于是,这个项目就诞生了。TypeSc... 查看详情

php开发paypal支付,支付流程和接口实现方案

参考技术A近期由于要开发公司外贸商城,需要对接Paypal支付。在开发过程中发现有好多坑。文档都是英文文档(主要还是自己英文水平不过关)、网上找的那些翻译过的文档老旧、沙箱环境网站卡的要让人崩溃。整个过程真是... 查看详情

接口文档

什么是接口文档?  在项目开发中,web项目的前后端分离开发,APP开发,需要由前后端工程师共同定义接口,编写接口文档,之后大家都根据这个接口文档进行开发,到项目结束前都要一直维护。  为什么要使用接口文档?... 查看详情

转:swagger2自动生成接口文档和mock模拟数据

...之后带来的困扰,那怎么来解决这些问题?问题一的一般解决方案:后端团队共同维护一个在线文档,每次改接口再去改对应的文档,但难免会遗漏,花的大力气但却效果平平。问题二的一般解决方案:自己搭建一个Mock服务器... 查看详情

如何用ascendcl的接口开发网络模型推理场景下应用?

摘要:本期我们来深入讲解网络模型推理场景下,具体怎么做。本文分享自华为云社区《【CANN文档速递09期】应用开发之推理场景》,作者: 昇腾CANN。我们知道,使用AscendCL接口开发应用时,典型场景包... 查看详情

移动端开发流程分享

...,导致项目周期有所影响并严重影响开发效率和开发质量,解决方案:再产品需求、原型设计及UI阶段,开发需要严格把控质量,帮助产品提升交付件的质量2.由于接口开发人员未讨论确定接口具体细节,接口需求方和接口开发者只通过... 查看详情

webpack前后端分离开发接口调试解决方案,proxytable解决方案

如果你有单独的后端开发服务器API,并且希望在同域名下发送API请求,那么代理某些URL会很有用。dev-server使用了非常强大的 http-proxy-middleware 包。更多高级用法,请查阅其文档。在 localhost:3000 上有后端服务的话,... 查看详情

[网络开发]同步与线程安全方案

方案:synchronized,volatile+CAS(compareAndSet),atomic包,Lock接口java同步和IO同步的对比:都是同步异步的方案问题,一个操作的是java代码(实际是堆和方法区),一个操作的是TCPRecvBuffer而已 线程安全方案:https://www.cnblogs.com/jianmianru... 查看详情

六大接口管理平台,总有一款适合你的!

...化测试,需要编写脚本。Eolinker是国内企业级IT研发管理解决方案服务品牌,在线API接口管理服务供应商,致力于满足各行业客户在不同应用环境中对研发管理全生命周期的个性化需求,提供API开发管理(AMS)、开发团队协作、... 查看详情

springboot整合lkadoc强大的api接口文档自动生成(代码片段)

简介  Lkadoc是一款开源的接口文档自动生成工具,基于SpringBoot平台,拥有非常强大的接口文档管理功能。为解决Java后台开发人员编写接口文档、调试接口而生。同时提供了简洁、大气、功能丰富的接口文档UI操作界面,方便... 查看详情

springboot简单使用swagger(代码片段)

...口文档往往很容易就跟不上代码了。发现了痛点就要去找解决方案。解决方案用的人多了,就成了标准的规范,这就是Swagger的由来。通过这套规范,你只需要按照它的规范去定义接口及接口相关的信息。再通过Swagger... 查看详情

收集各类开发接口文档

微信公众平台技术文档https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421137025 查看详情

jmeter单接口测试方案(接口无业务关联)

...使用,但没有说到具体怎么投入到项目使用,主要介绍了接口测试定义,流程和环境部署,所以我今天要说的就是我是怎么将这个方案投入到实际中使用的。这套方案主要用于相互接口之间无业务关联的测试。结构设计与数据准... 查看详情

前端驱动的接口数据检查文档生成mock以及接口自动化测试全方位实战效果。(代码片段)

...#xff1f;经过一段时间的探索之后,最终我找到了如下的解决方案& 查看详情

swagger---api接口文档自动生成工具

1、API接口文档  前后端分离开发模式中,在项目中会创建Restful风格的API接口,供第三方或前端人员使用,那么前端人员在使用的过程中如何知道有哪些接口以及接口详细信息呢?在实际开发中,一般通过写API接口文档来进行... 查看详情

jmeter做http测试怎么设置并发数

参考技术A前言:  本文主要针对http接口进行测试,使用Jmeter工具实现。  Jmter工具设计之初是用于做性能测试的,它在实现对各种接口的调用方面已经做的比较成熟,因此,本次直接使用Jmeter工具来完成对Http接口的测试。... 查看详情

使用jmeter建立接口测试

...iOS输入法接口服务器,有很多重要的接口,例如:升级,网络开关,热词等。现在有3台机器过保要下线,新申请了3台机器,需要验证一下这3台机器接口的正确性。【测试步骤】1)确认接口首先从开发人员那里获取接口文档,... 查看详情