罗马-免SDK-红包版API-给CP

免SDK-CP对接


1.1 角色查询(必须)

简要描述:

  • 我方在后续运营活动时,会主动调用此接口查询角色真实信息,CP方需提供该接口,以便核对角色信息

注意

  • 此接口必须是服务端的数据,客户端的数据可能会被篡改,不可作为查询依据。

请求URL:

  • CP方提供

请求方式:

  • GET

参数:

参数名 必选 类型 说明
account string CP玩家登录账号
roleId string CP角色ID<br/>角色唯一标识
startTime string 角色数据的起始时间,毫秒级UNIX时间戳(用于受时间范围影响的角色数据,如累计充值)
endTime string 角色数据的截止时间,毫秒级UNIX时间戳(用于受时间范围影响的角色数据,如累计充值)
sign string 签名,参考《签名算法》

返回参数:

参数名 必选 类型 说明
code string 错误代码,00000为成功,其他值为失败,失败的情况下data可不传
msg string 错误描述
data json 角色数据,见下表

data:

参数名 必选 类型 说明
account string 玩家登录账号
roleId string 角色唯一标识
nickName string 昵称
level string 角色等级
payAmount string 累计充值(2位精度小数)
deviceId string 设备ID/广告追踪ID<br/>取最后一次登录时的值
createTime string 角色创建时间,UNIX时间戳(毫秒)
type1 string 游戏角色数据1,协商后确定
type2 string 游戏角色数据2,协商后确定
type3 string 游戏角色数据3,协商后确定
type4 string 游戏角色数据4,协商后确定

成功返回示例:

{
    &quot;code&quot;: &quot;00000&quot;,
    &quot;msg&quot;: &quot;success&quot;,
    &quot;data&quot;:{
        &quot;account&quot;: &quot;jackson&quot;,
        &quot;roleId&quot;: &quot;10001&quot;,
        &quot;nickName&quot;: &quot;Jack&quot;,
        &quot;level&quot;: &quot;20&quot;,
        &quot;payAmount&quot;: &quot;5432.21&quot;,
        &quot;createTime&quot;: &quot;1597723416107&quot;,
        &quot;deviceId&quot;:&quot;9464-5564-8888-4554&quot;,
        &quot;type1&quot;:&quot;0&quot;,
        &quot;type2&quot;:&quot;0&quot;,
        &quot;type3&quot;:&quot;0&quot;,
        &quot;type4&quot;:&quot;0&quot;
    }
}

错误返回示例:

{
    &quot;code&quot;: &quot;30000&quot;,
    &quot;msg&quot;: &quot;Request Params Error.&quot;,
}

页面列表

ITEM_HTML