用户列表
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>采用游标分页方式获取用户列表</li>
<li>用户列表按用户创建时间倒序排列</li>
</ul>
<p>[游标分页请求代码示例](<a href="https://www.showdoc.com.cn/gatewaypartnerv1/10914997007617396">https://www.showdoc.com.cn/gatewaypartnerv1/10914997007617396</a> "游标分页请求代码示例")</p>
<h5>请求URL</h5>
<ul>
<li><code>/member/list</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET</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>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">appId </td>
<td style="text-align: left;">是 </td>
<td style="text-align: left;">Long </td>
<td>应用 ID </td>
</tr>
<tr>
<td style="text-align: left;">memberId </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">Long </td>
<td>用户 ID </td>
</tr>
<tr>
<td style="text-align: left;">beginDate </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>注册开始时间，时间格式为"yyyy-MM-dd HH:mm:ss" </td>
</tr>
<tr>
<td style="text-align: left;">endDate </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>注册结束时间，时间格式为"yyyy-MM-dd HH:mm:ss" </td>
</tr>
<tr>
<td style="text-align: left;">updateBeginDate </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>用户信息更新时间开始时间，时间格式为"yyyy-MM-dd HH:mm:ss" </td>
</tr>
<tr>
<td style="text-align: left;">updateEndDate </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>用户信息更新时间结束时间，时间格式为"yyyy-MM-dd HH:mm:ss" </td>
</tr>
<tr>
<td style="text-align: left;">lastLoginBeginDate</td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>最后登录开始时间，时间格式为"yyyy-MM-dd HH:mm:ss"</td>
</tr>
<tr>
<td style="text-align: left;">lastLoginEndDate </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>最后登录结束时间，时间格式为"yyyy-MM-dd HH:mm:ss"</td>
</tr>
<tr>
<td style="text-align: left;">cursor </td>
<td style="text-align: left;">否 </td>
<td style="text-align: left;">string </td>
<td>游标（初始为 null，后续请求附带上次翻页的游标）</td>
</tr>
<tr>
<td style="text-align: left;">size </td>
<td style="text-align: left;">是 </td>
<td style="text-align: left;">Integer</td>
<td>页大小范围：[1, 100]，即最小值为1，最大值为100 </td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;cursor&quot;: &quot;15525059981479936&quot;,
&quot;isLast&quot;: false,
&quot;list&quot;: [
{
&quot;appId&quot;: 1000,
&quot;code&quot;: 8,
&quot;createDateTime&quot;: &quot;2023-07-24 14:21:20&quot;,
&quot;headImgUrl&quot;: &quot;&quot;,
&quot;id&quot;: 276416865004294144,
&quot;ip&quot;: &quot;101.40.83.18&quot;,
&quot;lastLoginTime&quot;: &quot;0001-01-01 00:00:00&quot;,
&quot;loginCount&quot;: 0,
&quot;memberName&quot;: &quot;游客&quot;,
&quot;mobile&quot;: &quot;&quot;,
&quot;partnerId&quot;: 1001,
&quot;promotionId&quot;: 0,
&quot;promotionKeywords&quot;: &quot;xxx&quot;,
&quot;state&quot;: 1,
&quot;ua&quot;: &quot;Mozilla/5.0 (Linux; Android 12; ANA-AN00 Build/HUAWEIANA-AN00; wv) ...&quot;,
&quot;adChannelType&quot;: 1,
&quot;adId&quot;: &quot;xxx&quot;,
&quot;advertiserId&quot;: &quot;xxx&quot;,
&quot;updateDateTime&quot;: &quot;2023-07-24 14:21:20&quot;,
&quot;openId&quot;: &quot;oTvie6TUIXsvR8WOmf2yE8PTpQik&quot;
},
{
&quot;appId&quot;: 1000,
&quot;code&quot;: 10045,
&quot;createDateTime&quot;: &quot;2023-07-27 20:11:03&quot;,
&quot;headImgUrl&quot;: null,
&quot;id&quot;: 15525059981479936,
&quot;ip&quot;: &quot;101.40.83.18&quot;,
&quot;lastLoginTime&quot;: null,
&quot;loginCount&quot;: null,
&quot;memberName&quot;: &quot;游客&quot;,
&quot;mobile&quot;: null,
&quot;partnerId&quot;: 10703379290656768,
&quot;promotionKeywords&quot;: &quot;xxx&quot;,
&quot;promotionId&quot;: null,
&quot;state&quot;: null,
&quot;ua&quot;: &quot;Mozilla/5.0 (Linux; Android 12; ANA-AN00 Build/HUAWEIANA-AN00; wv) ...&quot;,
&quot;adChannelType&quot;: 1,
&quot;adId&quot;: &quot;xxx&quot;,
&quot;advertiserId&quot;: &quot;xxx&quot;,
&quot;updateDateTime&quot;: &quot;2023-07-27 20:11:03&quot;,
&quot;openId&quot;: &quot;tTvie6TUIXsvR8WOmf2yE8PTpQiq&quot;
}
]
},
&quot;msg&quot;: &quot;OK&quot;,
&quot;traceId&quot;: &quot;08111592-4add-4cbf-b0a1-15f66ed74604&quot;
}</code></pre>
<h5>返回参数说明</h5>
<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;">Integer </td>
<td>返回码 </td>
</tr>
<tr>
<td style="text-align: left;">msg </td>
<td style="text-align: left;">String </td>
<td>返回消息 </td>
</tr>
<tr>
<td style="text-align: left;">traceId </td>
<td style="text-align: left;">String </td>
<td>链路追踪 ID </td>
</tr>
<tr>
<td style="text-align: left;">data </td>
<td style="text-align: left;">Object </td>
<td>游标分页返回数据列表响应 </td>
</tr>
</tbody>
</table>
<h6>游标分页返回数据列表响应结构</h6>
<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;">cursor </td>
<td style="text-align: left;">String </td>
<td>游标（下次翻页带上该参数）</td>
</tr>
<tr>
<td style="text-align: left;">isLast </td>
<td style="text-align: left;">Boolean </td>
<td>是否最后一页 </td>
</tr>
<tr>
<td style="text-align: left;">list </td>
<td style="text-align: left;">List </td>
<td>数据列表 </td>
</tr>
</tbody>
</table>
<h6>数据列表项响应结构</h6>
<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;">id </td>
<td style="text-align: left;">Long </td>
<td>用户 ID </td>
</tr>
<tr>
<td style="text-align: left;">memberName </td>
<td style="text-align: left;">String </td>
<td>用户名称 </td>
</tr>
<tr>
<td style="text-align: left;">createDateTime </td>
<td style="text-align: left;">DateTime</td>
<td>创建时间 </td>
</tr>
<tr>
<td style="text-align: left;">updateDateTime </td>
<td style="text-align: left;">DateTime</td>
<td>更新时间 </td>
</tr>
<tr>
<td style="text-align: left;">headImgUrl </td>
<td style="text-align: left;">String </td>
<td>头像 </td>
</tr>
<tr>
<td style="text-align: left;">mobile </td>
<td style="text-align: left;">String </td>
<td>绑定手机号 </td>
</tr>
<tr>
<td style="text-align: left;">partnerId </td>
<td style="text-align: left;">Long </td>
<td>所属子分销商 ID </td>
</tr>
<tr>
<td style="text-align: left;">appId </td>
<td style="text-align: left;">Long </td>
<td>归属应用 ID </td>
</tr>
<tr>
<td style="text-align: left;">promotionId </td>
<td style="text-align: left;">Long </td>
<td>推广 ID </td>
</tr>
<tr>
<td style="text-align: left;">promotionKeywords</td>
<td style="text-align: left;">String</td>
<td>推广链接口令</td>
</tr>
<tr>
<td style="text-align: left;">loginCount </td>
<td style="text-align: left;">Integer </td>
<td>登录次数 </td>
</tr>
<tr>
<td style="text-align: left;">lastLoginTime </td>
<td style="text-align: left;">DateTime</td>
<td>最近登录时间 </td>
</tr>
<tr>
<td style="text-align: left;">code </td>
<td style="text-align: left;">Long </td>
<td>用户 code </td>
</tr>
<tr>
<td style="text-align: left;">state </td>
<td style="text-align: left;">Integer </td>
<td>状态：1-正常；2-隐藏</td>
</tr>
<tr>
<td style="text-align: left;">ip</td>
<td style="text-align: left;">String</td>
<td>IP</td>
</tr>
<tr>
<td style="text-align: left;">ua</td>
<td style="text-align: left;">String</td>
<td>UA</td>
</tr>
<tr>
<td style="text-align: left;">adChannelType</td>
<td style="text-align: left;">Integer</td>
<td>广告媒体渠道类型：</br>1-巨量；</br>2-腾讯MP；</br>3-腾讯ADQ；</br>4-快手；</br>5-百度；</br>6-其它；</br>7-UC；</br>8-VIVO；</br>9-OPPO；</br>10-HUAWEI；</br>11-HONOR；</br>12-小米</td>
</tr>
<tr>
<td style="text-align: left;">advertiserId</td>
<td style="text-align: left;">String</td>
<td>广告账户 ID</td>
</tr>
<tr>
<td style="text-align: left;">adId</td>
<td style="text-align: left;">String</td>
<td>广告计划 ID</td>
</tr>
<tr>
<td style="text-align: left;">openId</td>
<td style="text-align: left;">String</td>
<td>用户在小程序或公众号的 openid</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>返回错误代码请查看[错误响应](<a href="https://www.showdoc.com.cn/gatewaypartnerv1/10903560257841502">https://www.showdoc.com.cn/gatewaypartnerv1/10903560257841502</a> "错误响应")页面描述</li>
</ul>