《三十六计》联合运营访问接口设计.docx
《《三十六计》联合运营访问接口设计.docx》由会员分享，可在线阅读，更多相关《《三十六计》联合运营访问接口设计.docx（17页珍藏版）》请在冰豆网上搜索。
《三十六计》联合运营访问接口设计
三十六计联合运营接口
1.登录接口2
1.1.接口说明2
1.2.接口格式2
1.3.auth传送数据2
1.4.verify数据接口说明2
1.5.接口返回数据2
2.充值接口3
2.1.接口说明3
2.2.接口格式3
2.3.auth传送数据3
2.4.verify数据接口说明3
2.5.接口返回数据4
3.订单查询接口4
3.1.接口说明4
3.2.接口格式4
3.3.auth传送数据4
3.4.verify数据接口说明4
3.5.接口返回数据4
4.服务器信息查询接口5
4.1.接口说明5
4.2.接口格式5
4.3.auth传送数据5
4.4.verify数据接口说明5
4.5.接口返回数据5
5.用户存在信息查询6
5.1.接口说明6
5.2.接口格式6
5.3.auth传送数据6
5.4.verify数据接口说明6
5.5.接口返回数据6
6用户发展分查询接口7
6.1.接口说明7
6.2.接口格式7
6.3.auth传送数据7
6.4.verify数据接口说明7
6.5.接口返回数据7
7用户选举资格查询接口8
7.1.接口说明8
7.2.接口格式8
7.3.auth传送数据8
7.4.verify数据接口说明8
7.5.接口返回数据8
1.
登录接口
1.1.接口说明
登录接口是通过WEB访问方式发送给登录接口。
1.2.接口格式
登录的接口如下：
参数说明：
参数
说明
action
接口操作，login表示为登录游戏操作。
auth
传送数据，包括用户帐号等信息。
数据通过base64编码。
verify
auth数据的校验码，用来校验数据是否恶意修改。
1.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
tid=1&sid=55&account=username&pwd=e10adc3949ba59abbe56e057f20f883e&ip=210.110.110.110&time=1254984732
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
account
用户帐号
必要
pwd
密码md5加密串（如果提供不了,取帐号的前3\4位）（可以为空）
必要
ip
客服端ip
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
1.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
密钥为指定的字符串：
1.5.接口返回数据
此接口通过URL跳转调用实现。
-9系统错误-10：
商号错误
-11：
校验码错误-12：
参数错误
-13：
参数错误-14：
无效时间戳
2.充值接口
2.1.接口说明
使用金币充值接口可以直接向游戏中的指定帐号增加虚拟货币黄金。
2.2.接口格式
充值的接口如下：
参数说明：
参数
说明
action
接口操作，charge表示为充值游戏操作。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
2.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
account
用户帐号
必要
oid
订单号char（32）
必要
otype
订单类型（0,直接充值,1虚拟币兑换）
必要
money
花费金额
必要
gold
获得黄金的数量。
默认1RMB=10GOLD
必要
ip
客服端ip
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
2.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
2.5.接口返回数据{result:
1}
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳-15：
冲值金额错误
-16：
黄金数量错误-17：
无效玩家帐号
0：
其他错误1：
成功
--------------------------------------------------------------------------------------------------------------
3.订单查询接口
3.1.接口说明
使用订单查询接口查询订单信息。
3.2.接口格式
充值的接口如下：
参数说明：
参数
说明
action
接口操作，checkOrder表示为充值游戏操作。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
3.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
oid
订单号
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
3.3.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
3.4.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳
0：
无此订单号1：
成功
{result:
1,order:
”base64”}
Base64:
oid=订单号&otype=订单类型&account=帐号&sid=服务器编号&money=金额&gold=黄金&pdt=订单时间
4.服务器信息查询
4.1.接口说明
查询各个服务器信息
4.2.接口格式
充值的接口如下：
参数说明：
参数
说明
action
接口操作，getServerList表示为获取服务器信息。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
4.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
4.3.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
4.4.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
无效时间戳
0：
无任何信息1：
成功
{"result":
1,"server":
[{"flag":
"0","registerFlag":
"0","roundEndTime":
"1970-01-0108:
00:
00","roundStartTime":
"1970-01-0108:
00:
00","serverCode":
"123456","serverGroup":
"test","serverLoginSum":
"16","serverName":
"test-双线1区","serverRegisterSum":
"21","serverStatus":
"0"}]}
registerFlag，0:
不可以注册，1:
可以注册,-1:
管理平台没有取到值
serverStatus，值为0，1，2默认为0不可手工直接修改该参数
0:
正常登陆
1:
所有玩家不可登陆
2:
代表只有允许地址可以访问
roundStartTime轮回开始时间
roundEndTime轮回结束时间
serverCode服务器ID
serverLoginSum在线人数
serverName服务器名
serverRegisterSum注册总人数
5.用户存在信息查询
5.1.接口说明
查询各个服务器信息
5.2.接口格式
充值的接口如下：
参数说明：
参数
说明
action
接口操作，charge表示为充值游戏操作。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
5.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
account
账号
必要
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
5.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
5.5.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳-15:
服务器编号出错
0：
无此账号1：
账号存在
成功:
{“result”:
1,”nickname”:
”\u5348\u591c\u51f6\u7075”}
6.用户发展分查询
6.1.接口说明
查询拥护发展分信息
6.2.接口格式
充值的接口如下：
此接口请用post方式传递过来
参数说明：
参数
说明
action
接口操作，getinfo表示为充值游戏操作。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
6.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
cpr
域名的中间部分,比如uuzu
必要
urs
用户列表（user1,user2）一次最多1000人
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
6.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
6.5.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳-15:
服务器编号出错
0：
无此用户1：
成功
7.用户选举资格查询
7.1.接口说明
查询用户选举资格
7.2.接口格式
充值的接口如下：
此接口请用get方式传递过来
参数说明：
参数
说明
action
接口操作，usercandi表示为充值游戏操作。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
7.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
cpr
域名的中间部分,比如uuzu
必要
user
用户名
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
7.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
7.5.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳-15:
服务器编号出错
-1：
不在竞选期间-2：
目前没有竞选
-3：
用户不存在-4：
用户没有资格
1：
有资格 {“result”:
1,”data”:
[{“user”:
用户名,”country”:
国家,”name”:
昵称}]}
8.取指定日期最大在线人数
8.1.接口说明
取指定日期最大在线人数
8.2.接口格式
充值的接口如下：
此接口请用get方式传递过来
参数说明：
参数
说明
action
接口操作，getMaxOnline表示为充值游戏操作。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
8.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
sdate
统计时间（2009-10-26）
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
8.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
8.5.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳-15:
服务器编号出错
-1：
不在竞选期间-2：
目前没有竞选
-3：
用户不存在-4：
用户没有资格
1：
有资格 {“result”:
1,”data”:
[{“user”:
用户名,”country”:
国家,”name”:
昵称}]}
9.取玩家排名
9.1.接口说明
取玩家排名
9.2.接口格式
充值的接口如下：
此接口请用get方式传递过来
参数说明：
参数
说明
action
接口操作，getUserRange表示为取玩家排行。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
9.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
9.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
9.5.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳
返回json格式
10.取玩家昵称
10.1.接口说明
取玩家昵称
10.2.接口格式
充值的接口如下：
此接口请用post方式传递过来
参数说明：
参数
说明
action
接口操作，getdetail表示为查询玩家昵称。
auth
传送数据，包括用户帐号，金额等信息。
数据通过base64编码．
verify
auth数据的校验码，用来校验数据是否恶意修改。
10.3.auth传送数据
auth数据串需经过base64进行编码。
数据结构：
param1=value1¶m2=value2¶m3=value3……
参数说明：
参数
说明
必要否
tid
商户编号
必要
sid
服务器编号
必要
urs
用户列表（user1,user2）一次最多1000人
必要
time
当前时间戳
必要
补充说明：
具体需要的参数根据需求可以增加。
”必要”为必填项
10.4.verify数据接口说明
使用MD5方法对auth数据串+密钥进行加密
10.5.接口返回数据
-10：
商号错误-11：
校验码错误
-12：
数据解析错误-13：
数据无效
-14：
无效时间戳
返回json格式
升级会员 