角色查询

接口描述

本接口提供给sdk服务器获取角色信息,用于支付时用户身份确认

请求方式:get

接口通知参数数据描述

参数
Y必须/N选填
类型
描述

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 (该秘钥仅供演示使用)

  1. 所有请求参数去掉空参数,sign不参与签名;

  2. 将参数按key的assic码升序排序,比如{key1:value1,key2:value2}

  3. 连接对应value值如value1value2,注意值中有中文等特殊符号的无需urlencode;

  4. 第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

参数
Y必须/N选填
类型
描述

status

Y

int

0成功1参数错误2用户不存在3请求超时4调用失败

msg

Y

string

success/fail

data

Y

Object[]

数据列表

data的Object数据

参数
Y必须/N选填
类型
描述

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?