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>