角色等级战力查询接口【必接】

1.文档记录

编码格式	密级
utf-8	公开

日期	版本	修改内容	操作人
2021-09-01	1.0.0	文档整理	朱明慧
2025-05-20	1.1.0	增加time过期和md5签名	朱金余
2025-12-23	1.1.1	角色等级接口返回数据增加创角时间,roletime	朱金余

2.接口地址

1.请求地址

游戏厂商提供,接口地址全服通用（即所有服共用一个url，通过areasign参数的值来区分区服），51平台通过该接口来查询某个用户在游戏的某个区服是否注册过，若注册过则返回角色名、等级，未注册过返回"sign":1

2.请求方式

GET

3.参数说明

参数名	类型	说明
areasign	string	区服ID,由51平台和游戏厂商协商决定；（跟充值接口中的goods_sign参数一致）；一般为s1,s2,s3…或者1，2，3…
user	string	51用户名，字母、数字、下划线构成，跟登录接口中的user参数一致
time	int	unixtime类型，10位数字，当前时间，秒级，建议与服务器时间超过300秒就禁止查询
sign	string	32位md5小写字符串，加密算法,php代码 $sign = md5($areasign.$user.$time.$sec_key); 其中$sec_key是登录接口的key

4.返回结果

条件	返回值示例说明
所有错误返回
存在一个角色	{"sign":2,"data":{"rolekey1":"角色1的名称"},"roletime":{"rolekey1":1766453167},"level":{"rolekey1":"角色1的等级"},"ce":{"rolekey1":"角色1的战力"}}
存在多个角色	{"sign":2,"data":{"rolekey1":"角色1名称","rolekey2":"角色2名称"},"roletime":{"rolekey1":1766453167,"rolekey2":1766453167},"level":{"rolekey1":"角色1等级","rolekey2":"角色2等级"},"ce":{"rolekey1":"角色1战力","rolekey2":"角色2战力"}} 多个角色键名用rolekey4，rolekey5..递增表示。 充值时我们会把用户选择的角色对应的键名即rolekey1,rolekey2... post给厂商，而不是post键值即角色名 角色键名最好传真实的角色id(没有角色id才使用rolekey1,rolekey2这种来代替) roletime是角色的创建时间，格式为unix时间戳，秒级

注意：

1. 等级一定要返回原始等级，而不是转生后的等级。
2. 如果用户删除了游戏内的某个角色，查询结果不要再返回已经删除的角色。
3. 原始等级计算规则：转生数*10000+转生后等级 如5转30 就返回50030 未转生的直接返回等级，前边不要加0
4. 返回结果没有[]，没有[]，没有[]，重要的事情说三遍,请仔细比对输出的数据结构，没有List。