获取客户群列表
<h5>简要描述</h5>
<ul>
<li>客户群列表</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://oapi-yzj.miaokol.com/wechat/rooms</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">app_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">APP ID</td>
</tr>
<tr>
<td style="text-align: left;">access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Access Token</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">页码，默认1</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">每页条数，默认10，最大100</td>
</tr>
<tr>
<td style="text-align: left;">rel_wxid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">在群服务的企微号wxid</td>
</tr>
<tr>
<td style="text-align: left;">wxids</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">群wxid，多个以英文逗号分隔，如：R:xxx1,R:xxx2</td>
</tr>
<tr>
<td style="text-align: left;">tag_ids</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;">群标签ID,数组，如：["9884"]， <font color="red"><strong>必须使用POST请求</strong></font></td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>POST /wechat/rooms HTTP/1.1
Host:oapi-yzj.miaokol.com
Content-Type: application/json; charset=UTF-8
{
&quot;app_id&quot;:&quot;xxx&quot;,
&quot;access_token&quot;:&quot;xxx&quot;,
&quot;page&quot;:1,
&quot;page_size&quot;:100
}
</code></pre>
<h5>响应示例</h5>
<pre><code>HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
&quot;data&quot;:[
{
&quot;id&quot;:1,
&quot;user_id&quot;:21,
&quot;sub_user_id&quot;:0,
&quot;corp_id&quot;:1,
&quot;wxid&quot;:&quot;R:&quot;,
&quot;avatar&quot;:&quot;//qiyunbao.oss-cn-hangzhou.aliyuncs.com/avatar/1688850011358436/c9bf9a6964c59388c2a0e343a3851b54.png&quot;,
&quot;owner_wxid&quot;:&quot;xxxxx&quot;,
&quot;wx_ctime&quot;:1599007442,
&quot;corp_tag_wxids&quot;:&quot;&quot;,
&quot;ctime&quot;:1631268821,
&quot;utime&quot;:1631268821,
&quot;nickname&quot;:&quot;&quot;,
&quot;nickname_pinyin&quot;:&quot;&quot;,
&quot;member_count&quot;:3,
&quot;biz_bitval&quot;:0,
&quot;announcement&quot;:null,
&quot;invite_confirm&quot;:0
}
],
&quot;pager&quot;:{
&quot;page&quot;:1,
&quot;perPage&quot;:10,
&quot;numRecords&quot;:592,
&quot;numPages&quot;:60,
&quot;firstRecord&quot;:0,
&quot;lastRecord&quot;:9
},
&quot;errcode&quot;:0
}
</code></pre>
<h5>响应说明</h5>
<ul>
<li>data类型为数组，数组项格式说明如下</li>
</ul>
<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;">user_id</td>
<td style="text-align: left;">int</td>
<td>用户id</td>
</tr>
<tr>
<td style="text-align: left;">wxid</td>
<td style="text-align: left;">string</td>
<td>群微信id</td>
</tr>
<tr>
<td style="text-align: left;">owner_wxid</td>
<td style="text-align: left;">string</td>
<td>群主微信id</td>
</tr>
<tr>
<td style="text-align: left;">nickname</td>
<td style="text-align: left;">string</td>
<td>群名称</td>
</tr>
<tr>
<td style="text-align: left;">member_count</td>
<td style="text-align: left;">int</td>
<td>群成员人数</td>
</tr>
<tr>
<td style="text-align: left;">invite_confirm</td>
<td style="text-align: left;">int</td>
<td>群聊邀请是否需要确认：0否；1是；</td>
</tr>
<tr>
<td style="text-align: left;">tag_id</td>
<td style="text-align: left;">array</td>
<td>群标签id,[]或[xxx,xxx]，<font color="red"><strong>POST请求时才有该字段</strong></font></td>
</tr>
<tr>
<td style="text-align: left;">tags</td>
<td style="text-align: left;">array</td>
<td>群标签名称,[]或[xxx,xxx]，<font color="red"><strong>POST请求时才有该字段</strong></font></td>
</tr>
<tr>
<td style="text-align: left;">pager</td>
<td style="text-align: left;">object</td>
<td>分页信息</td>
</tr>
</tbody>
</table>