角色更新接口
<p><strong>简要描述:</strong> </p>
<ul>
<li>角色信息更新,收集角色区服数据</li>
</ul>
<p><strong>请求时机:</strong> </p>
<ul>
<li>根据不同时机,type传值不同
进入游戏:type=1
创建角色:type=2
角色升级:type=3
退出游戏:type=4</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://usdk.api.xxxxxx.com/s2s/role/update</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST/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>
<th>参与签名</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">game_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>游戏ID</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">agent_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>渠道ID(平台提供,区分不同渠道)</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">channel_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>渠道包ID(平台提供,区分不同游戏包)</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">device_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备ID(设备唯一标识,Android取deviceID或imei,iOS取uuid或idfa)</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>CP玩家账号ID(玩家账号唯一标识)</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时机类型,1进入游戏,2创建角色,3角色升级,4退出游戏</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">role_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色ID</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">role_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色名</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">server_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服ID</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">server_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服名</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">role_level</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>角色等级</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">role_vip</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>角色VIP等级</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名 <strong>MD5(channel_id+agent_id+device_id+game_id+role_id+server_id+type+user_id+game_key),其中“+”为链接符不加入签名计算,生成的字符串为小写 </strong></td>
<td>签名</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 200,
"msg": "数据保存成功"
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<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;">int</td>
<td>返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">数据保存成功</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">101</td>
<td style="text-align: left;">请求参数xxx错误</td>
<td>请检查必传参数xxx</td>
</tr>
<tr>
<td style="text-align: left;">102</td>
<td style="text-align: left;">game_id错误</td>
<td>无法匹配game_id和game_key</td>
</tr>
<tr>
<td style="text-align: left;">103</td>
<td style="text-align: left;">签名验证失败</td>
<td>请检查签名规则生成的签名串</td>
</tr>
<tr>
<td style="text-align: left;">104</td>
<td style="text-align: left;">数据保存失败</td>
<td>系统原因导致数据保存失败</td>
</tr>
<tr>
<td style="text-align: left;">105</td>
<td style="text-align: left;">玩家信息错误</td>
<td>请确更新的角色已调用过登录接口,后台有玩家数据</td>
</tr>
<tr>
<td style="text-align: left;">106</td>
<td style="text-align: left;">type错误</td>
<td>请检查type传值,只能传1,2,3,4</td>
</tr>
</tbody>
</table>