用户管理(会员账号)
会员(C端用户,sys_member)的查询展示与账号启停,对应管理端「用户管理」页面,手机号脱敏展示。
系统用户分页列表
接口地址
text
GET /admin/member/list接口说明
C端会员用户信息展示,按注册时间倒序。
接口参数说明
| Query 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 否 | 搜索关键字(昵称/姓名/账号/手机号) |
status | integer | 否 | 账号状态 1启用 2禁用 |
register_source | integer | 否 | 注册来源 1微信小程序 2微信公众号 3iOS 4Android |
page | integer | 否 | 页码,默认 1 |
page_size | integer | 否 | 每页数量,默认 20,最大 100 |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"list": [
{
"id": 1,
"created_at": "2026-09-25T10:00:00+08:00",
"updated_at": "2026-09-25T10:00:00+08:00",
"sn": "cfk3m9x2a",
"nickname": "小小",
"real_name": "王小民",
"account": "xiaoxiaomin",
"mobile": "138****8001",
"avatar": "/files/2026/09/25/8f14e45fceea167a5a36dedd4bea2543.png",
"gender": 1,
"age": 26,
"birthday": "1999-01-01",
"register_ip": "",
"login_ip": "",
"registered_at": "2026-09-25T10:00:00+08:00",
"logged_at": "2026-09-25T10:00:00+08:00",
"balance": "128.50",
"register_source": 1,
"status": 1
}
],
"total": 36
}
}响应参数说明
| 响应字段 | 类型 | 说明 |
|---|---|---|
list | array<MemberItem> | |
list[].id | integer | 主键ID |
list[].created_at | string | 创建时间 |
list[].updated_at | string | 更新时间 |
list[].sn | string | 用户编号,全局唯一,cf 前缀 + 8 位小写字母和数字 |
list[].nickname | string | 昵称 |
list[].real_name | string | 姓名 |
list[].account | string | 登录账号 |
list[].mobile | string | 手机号,脱敏展示(如 138****8001) |
list[].avatar | string | 头像访问地址(按当前默认存储动态生成) |
list[].gender | integer | 性别 1男 2女 3未知 |
list[].age | integer | 年龄 |
list[].birthday | string | 出生日期,格式 YYYY-MM-DD,未设置为空串 |
list[].register_ip | string | 注册IP |
list[].login_ip | string | 最近登录IP |
list[].registered_at | string | 注册时间,未设置为 null |
list[].logged_at | string | 最近登录时间,未设置为 null |
list[].balance | string | 账户余额,两位小数字符串,避免浮点精度问题 |
list[].register_source | integer | 注册来源 1微信小程序 2微信公众号 3iOS 4Android |
list[].status | integer | 账号状态 1启用 2禁用 |
total | integer | 数据总数 |
启用/禁用系统用户账号
接口地址
text
POST /admin/member/set_status接口说明
目标状态与当前状态一致时幂等返回成功。
接口参数说明
| Body 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 是 | 用户ID |
status | integer | 是 | 目标状态 1启用 2禁用 |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"code": 0,
"msg": "success",
"data": null
}
}响应参数说明
成功时 data 为 null。