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

免SDK-CP对接


1.1 角色查询(必须)

<p><strong>简要描述:</strong></p> <ul> <li>我方在后续运营活动时,会主动调用此接口查询角色真实信息,CP方需提供该接口,以便核对角色信息</li> </ul> <p><strong> 注意 </strong></p> <ul> <li>此接口必须是服务端的数据,客户端的数据可能会被篡改,不可作为查询依据。</li> </ul> <p><strong>请求URL:</strong></p> <ul> <li>CP方提供</li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>GET</li> </ul> <p><strong> 参数:</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">account</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>CP玩家登录账号</td> </tr> <tr> <td style="text-align: left;">roleId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>CP角色ID<br/>角色唯一标识</td> </tr> <tr> <td style="text-align: left;">startTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>角色数据的起始时间,毫秒级UNIX时间戳(用于受时间范围影响的角色数据,如累计充值)</td> </tr> <tr> <td style="text-align: left;">endTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>角色数据的截止时间,毫秒级UNIX时间戳(用于受时间范围影响的角色数据,如累计充值)</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名,参考《签名算法》</td> </tr> </tbody> </table> <p><strong> 返回参数:</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>错误代码,00000为成功,其他值为失败,失败的情况下data可不传</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>错误描述</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">否</td> <td style="text-align: left;">json</td> <td>角色数据,见下表</td> </tr> </tbody> </table> <p><strong> data:</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">account</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>玩家登录账号</td> </tr> <tr> <td style="text-align: left;">roleId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>角色唯一标识</td> </tr> <tr> <td style="text-align: left;">nickName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>昵称</td> </tr> <tr> <td style="text-align: left;">level</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>角色等级</td> </tr> <tr> <td style="text-align: left;">payAmount</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>累计充值(2位精度小数)</td> </tr> <tr> <td style="text-align: left;">deviceId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>设备ID/广告追踪ID<br/><strong>取最后一次登录时的值</strong></td> </tr> <tr> <td style="text-align: left;">createTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>角色创建时间,UNIX时间戳(毫秒)</td> </tr> <tr> <td style="text-align: left;">type1</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>游戏角色数据1,协商后确定</td> </tr> <tr> <td style="text-align: left;">type2</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>游戏角色数据2,协商后确定</td> </tr> <tr> <td style="text-align: left;">type3</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>游戏角色数据3,协商后确定</td> </tr> <tr> <td style="text-align: left;">type4</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>游戏角色数据4,协商后确定</td> </tr> </tbody> </table> <p><strong>成功返回示例:</strong></p> <pre><code>{ "code": "00000", "msg": "success", "data":{ "account": "jackson", "roleId": "10001", "nickName": "Jack", "level": "20", "payAmount": "5432.21", "createTime": "1597723416107", "deviceId":"9464-5564-8888-4554", "type1":"0", "type2":"0", "type3":"0", "type4":"0" } }</code></pre> <p><strong>错误返回示例:</strong></p> <pre><code>{ "code": "30000", "msg": "Request Params Error.", }</code></pre>

页面列表

ITEM_HTML