POST
/member/queryMemberPage管理后台分页查询会员信息
会员 / 会员
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/member/queryMemberPage - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台(1 个前端)
- 需求上下文
- 维护人 / 最后改动luoli 2024-03-29
- 读写数据表
member反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.member.MemberController#queryMemberPage - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/member/MemberController.java:81 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无(渠道统一鉴权头见《认证方式》) | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| pageNo | … | 否 | Integer | 当前页面 |
| pageSize | … | 否 | Integer | 每页记录数 |
| orderBy | … | 否 | String | 排序语句 |
| mobile | … | 否 | String | 会员手机号 → member.mobile |
| createdTimeRange | … | 否 | Date[] | 注册时间范围 |
| status | … | 否 | Integer | 会员状态 → member.status |
| channel | … | 否 | ChannelType | 所属渠道,1北京卡管理系统,2三省卡系统,3数字平台,4质惠游 → member.channel 1=北京卡管理系统 2=三省卡系统 3=数字平台 4=质惠游 5=支付宝 6=兴业银行 7=湘工惠 8=湘约码 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| list | … | 否 | List<T><MemberPageResponse> | 分页数据集合(元素结构见下一行) |
| id | … | 否 | Long | 编号 → member.id |
| channel | … | 否 | ChannelType | → member.channel 1=北京卡管理系统 2=三省卡系统 3=数字平台 4=质惠游 5=支付宝 6=兴业银行 7=湘工惠 8=湘约码 |
| thirdId | … | 否 | String | → member.third_id |
| openId | … | 否 | String | openId → member.open_id |
| mobile | … | 否 | String | 手机号 → member.mobile |
| password | … | 否 | String | 密码 → member.password |
| status | … | 否 | Integer | 状态 → member.status |
| registerIp | … | 否 | String | 注册 IP → member.register_ip |
| registerTerminal | … | 否 | Integer | 注册终端 → member.register_terminal |
| loginIp | … | 否 | String | 最后登录IP → member.login_ip |
| loginDate | … | 否 | Date | 最后登录时间 → member.login_date |
| nickname | … | 否 | String | 用户昵称 → member.nickname |
| avatar | … | 否 | String | 头像 → member.avatar |
| name | … | 否 | String | 真实名字 → member.name |
| sex | … | 否 | Integer | 用户性别 → member.sex |
| areaId | … | 否 | Long | 所在地 → member.area_id |
| birthday | … | 否 | Date | 出生日期 → member.birthday |
| mark | … | 否 | String | 会员备注 → member.mark |
| point | … | 否 | Integer | 积分 → member.point |
| tagIds | … | 否 | String | 用户标签编号列表,以逗号分隔 → member.tag_ids |
| levelId | … | 否 | Long | 等级编号 → member.level_id |
| experience | … | 否 | Integer | 经验 → member.experience |
| groupId | … | 否 | Long | 用户分组编号 → member.group_id |
| isDeleted | … | 否 | Boolean | 是否删除 → member.is_deleted |
| createdTime | … | 否 | Date | 创建时间 → member.created_time |
| updatedTime | … | 否 | Date | 更新时间 → member.updated_time |
| total | … | 否 | Long | 数据总数 |
响应示例
成功响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"list": "[]",
"id": "1",
"channel": "1",
"thirdId": "\"string\"",
"openId": "\"string\"",
"mobile": "\"string\"",
"password": "\"string\"",
"status": "1",
"registerIp": "\"string\"",
"registerTerminal": "1",
"loginIp": "\"string\"",
"loginDate": "\"2026-01-01 00:00:00\""
}
}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:member 反查全部引用接口 →
- MemberController#queryMemberPage
- MemberService#queryPage(MemberServiceImpl)
- MemberMapper#queryPage
- BeanUtils.map → MemberQuery
- BeanUtils.mapPage → MemberPageResponse
逻辑摘要:分页查询(memberService.queryPage);入参与返回值经 BeanUtils 做对象/分页映射
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)
调用点证据
dscp-html-manage/src/api/member/userInfo/index.ts:4管理后台 · request