角色查询
接口描述
本接口提供给sdk服务器获取角色信息,用于支付时用户身份确认
请求方式:get
接口通知参数数据描述
site
Y
string
默认R2Games
game
Y
string
双方约定
serverid
Y
string
服务器ID
roleid
N
string
玩家游戏内唯一角色标示ID
rolename
N
string
玩家角色名
username
N
string
R2方账号uid,即 r2uid
time
Y
int
Unix时间戳,超时验证,10分钟内有效
sign
Y
string
数据签名
roleid,rolename,username必须填其中的一个或多个,每个游戏条件不同,可以做对应选择
MD5签名
示例数据
apiKey:abcd (该秘钥仅供演示使用)
所有请求参数去掉空参数,sign不参与签名;
将参数按key的assic码升序排序,比如{key1:value1,key2:value2}
连接对应value值如value1value2,注意值中有中文等特殊符号的无需urlencode;
第3步生成的字符串直接拼接,末尾连接apiKey,然后进行md5(value1value2abcd),即可得到sign。
示例: https://xxx.r2game.com/api/roleInfo?game=test&site=R2Games&serverid=20000&time=1656432000&roleid=38000000&sign=39bd31bb832993537b3a6402fefe86fe
其中: sign= md5('test3800000020000R2Games1656432000abcd')
返回数据说明 json
status
Y
int
0成功1参数错误2用户不存在3请求超时4调用失败
msg
Y
string
success/fail
data
Y
Object[]
数据列表
data的Object数据
username
Y
string
R2方账号uid,即 r2uid
roleid
Y
string
角色ID(游戏内)-游戏内唯一用户标识
rolename
Y
string
角色名称
level
Y
string
角色等级
返回示例:
{"status":0,"msg":"success","data":[{"username":"112334","roleid":"1233412","rolename":"ceshideren","level":"1"}]}
Last updated
Was this helpful?