角色列表、区服列表、按渠道拉取区服列表
<p>[TOC]</p>
<h2>1、接口功能说明</h2>
<pre><code>CP需向我方提供 `角色列表`，`区服列表`，`按渠道拉取区服列表`，共用一个入口地址，通过请求参数type区分。</code></pre>
<h5>请求URL</h5>
<ul>
<li>CP方提供</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
<li>Content-Type:application/json</li>
</ul>
<h5>签名方式</h5>
<ul>
<li>同封禁请求[ <a href="https://www.showdoc.com.cn/p/85c2f3d8fe2f167177256afb9bd91118">https://www.showdoc.com.cn/p/85c2f3d8fe2f167177256afb9bd91118</a> ]</li>
</ul>
<h2>2、查询角色列表（userList）</h2>
<h5>请求参数</h5>
<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;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口标识，角色列表 userList，区服列表 serverList，按渠道拉取区服列表 serverAll</td>
</tr>
<tr>
<td style="text-align: left;">game </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>乐玩游戏标识</td>
</tr>
<tr>
<td style="text-align: left;">uid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>乐玩平台uid</td>
</tr>
<tr>
<td style="text-align: left;">channel</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户所属渠道，如aiweiyou</td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>时间戳，单位为:s</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>
<h5>返回示例</h5>
<pre><code>// 成功
{
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;ok&quot;,
&quot;d&quot;: [
{
&quot;roleId&quot;: &quot;111&quot;,
&quot;roleName&quot;: &quot;角色昵称&quot;,
&quot;serverId&quot;: &quot;区服（服务器）id&quot;,
&quot;serverName&quot;: &quot;区服（服务器）名称&quot;,
&quot;power&quot;: 0,
&quot;level&quot;: 100,
&quot;createTime&quot;: &quot;2025-06-10 11:00:00&quot;
},
{
&quot;roleId&quot;: &quot;222&quot;,
&quot;roleName&quot;: &quot;角色昵称&quot;,
&quot;serverId&quot;: &quot;区服（服务器）id&quot;,
&quot;serverName&quot;: &quot;区服（服务器）名称&quot;,
&quot;power&quot;: 0,
&quot;level&quot;: 200,
&quot;createTime&quot;: &quot;2025-06-10 12:00:00&quot;
}
]
}
// 异常
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;参数错误&quot;}
</code></pre>
<h5>响应参数说明</h5>
<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;">integer</td>
<td>请求状态，1成功，非1值视为失败</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;">d</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>数组对象</td>
</tr>
<tr>
<td style="text-align: left;">d.roleId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色id</td>
</tr>
<tr>
<td style="text-align: left;">d.roleName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色名称</td>
</tr>
<tr>
<td style="text-align: left;">d.serverId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服（服务器）id</td>
</tr>
<tr>
<td style="text-align: left;">d.serverName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服（服务器）名称</td>
</tr>
<tr>
<td style="text-align: left;">d.createTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>角色id</td>
</tr>
<tr>
<td style="text-align: left;">d.power</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">integer</td>
<td>战力，无传0</td>
</tr>
<tr>
<td style="text-align: left;">d.level</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">integer</td>
<td>角色等级，无传0</td>
</tr>
</tbody>
</table>
<h2>3、区服列表（serverList）</h2>
<h5>请求参数</h5>
<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;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口标识，角色列表 userList，区服列表 serverList，按渠道拉取区服列表 serverAll</td>
</tr>
<tr>
<td style="text-align: left;">game </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>乐玩游戏标识</td>
</tr>
<tr>
<td style="text-align: left;">uid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>乐玩平台uid</td>
</tr>
<tr>
<td style="text-align: left;">channel</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户所属渠道，如aiweiyou</td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>时间戳，单位为:s</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>
<h5>返回示例</h5>
<pre><code>// 成功
{
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;ok&quot;,
&quot;d&quot;: [
{
&quot;serverid&quot;: &quot;区服（服务器）id1111&quot;,
&quot;servername&quot;: &quot;区服（服务器）名称1111&quot;
},
{
&quot;serverid&quot;: &quot;区服（服务器）id2222&quot;,
&quot;servername&quot;: &quot;区服（服务器）名称2222&quot;
}
]
}
// 异常
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;参数错误&quot;}
</code></pre>
<h5>响应参数说明</h5>
<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;">integer</td>
<td>请求状态，1成功，非1值视为失败</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;">d</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>数组对象</td>
</tr>
<tr>
<td style="text-align: left;">d.serverId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服（服务器）id</td>
</tr>
<tr>
<td style="text-align: left;">d.serverName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服（服务器）名称</td>
</tr>
</tbody>
</table>
<h2>4、按渠道拉取区服列表（serverAll）</h2>
<h5>请求参数</h5>
<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;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口标识，角色列表 userList，区服列表 serverList，按渠道拉取区服列表 serverAll</td>
</tr>
<tr>
<td style="text-align: left;">game </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>乐玩游戏标识</td>
</tr>
<tr>
<td style="text-align: left;">channel</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户所属渠道，如aiweiyou</td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>时间戳，单位为:s</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>
<h5>返回示例</h5>
<pre><code>// 成功
{
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;ok&quot;,
&quot;d&quot;: [
{
&quot;serverId&quot;: &quot;区服（服务器）id&quot;,
&quot;serverName&quot;: &quot;区服（服务器）名称&quot;,
&quot;startTime&quot;: &quot;2025-06-10 11:00:00&quot;,
&quot;status&quot;: 0
},
{
&quot;serverId&quot;: &quot;区服（服务器）id&quot;,
&quot;serverName&quot;: &quot;区服（服务器）名称&quot;,
&quot;startTime&quot;: &quot;2025-06-10 12:00:00&quot;,
&quot;status&quot;: 2
}
]
}
// 异常
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;参数错误&quot;}
</code></pre>
<h5>响应参数说明</h5>
<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;">integer</td>
<td>请求状态，1成功，非1值视为失败</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;">d</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>数组对象</td>
</tr>
<tr>
<td style="text-align: left;">d.serverId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服（服务器）id</td>
</tr>
<tr>
<td style="text-align: left;">d.serverName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>区服（服务器）名称</td>
</tr>
<tr>
<td style="text-align: left;">d.startTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开服时间</td>
</tr>
<tr>
<td style="text-align: left;">d.status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">integer</td>
<td>0：关闭，1：期待，2：开启，3：维护</td>
</tr>
</tbody>
</table>