2.1 角色上报（必接）
<p><strong>简要描述：</strong></p>
<ul>
<li>CP方需在玩家创建角色后、或登录设备发生变更、或角色升级时，<strong>在后端</strong>调用此接口，其中角色ID、设备ID将作为后续查询用户奖励的关键依据。</li>
</ul>
<p><strong>调用时机：</strong></p>
<ul>
<li>1.首次创建角色；</li>
<li>2.登录设备发生变更；</li>
<li>3.角色升级时；</li>
</ul>
<p><strong>请求URL：</strong></p>
<ul>
<li>/api/cp/v1/init</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>Content-Type</strong></p>
<ul>
<li>application/json;charset=UTF-8</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;">cpId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>CP公司ID（固定值，CP公司在我方的唯一标识）</td>
</tr>
<tr>
<td style="text-align: left;">gameId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>CP公司游戏ID（若没有则由我方指定）</td>
</tr>
<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角色唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">serverId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服ID，默认：1</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;">osType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>系统类型：android/ios</td>
</tr>
<tr>
<td style="text-align: left;">osVer</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>系统版本号，如：9_28</td>
</tr>
<tr>
<td style="text-align: left;">model</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手机型号，如：PBBM00</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>错误码</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>
</tbody>
</table>
<p><strong>成功返回示例：</strong></p>
<pre><code>{
"code": "00000",
"msg": "success"
}</code></pre>
<p><strong>失败返回示例：</strong></p>
<pre><code>{
"code": "30000",
"msg": "Request Params Error."
}</code></pre>