pangu-user-platform/docs/接口清单.md

盘古用户认证中心 - 接口清单

本文档列出系统所有接口的地址和说明
作者: pangu
更新日期: 2026-02-03

---

一、H5端接口

1.1 H5认证接口

接口说明	请求方式	接口地址
获取图形验证码	GET	/h5/auth/captcha
发送短信验证码	POST	/h5/auth/sms/send
密码登录	POST	/h5/auth/login/password
短信验证码登录	POST	/h5/auth/login/sms
会员注册	POST	/h5/auth/register
刷新Token	POST	/h5/auth/refresh
退出登录	POST	/h5/auth/logout
获取微信扫码登录二维码	GET	/h5/auth/wechat/qrcode
查询微信扫码状态	GET	/h5/auth/wechat/status/{ticket}
微信扫码登录	POST	/h5/auth/wechat/login
发送微信绑定手机号短信验证码	POST	/h5/auth/wechat/sms/send
微信登录绑定手机号	POST	/h5/auth/wechat/bindPhone
微信回调处理	GET	/h5/auth/wechat/callback
清除短信限制（调试用）	DELETE	/h5/auth/debug/sms-limit/{phone}

1.2 H5会员接口

接口说明	请求方式	接口地址
获取当前会员信息	GET	/h5/member/info
修改会员基本信息	PUT	/h5/member/info
修改登录密码	PUT	/h5/member/password
添加教育身份	POST	/h5/member/educations
获取教育身份列表	GET	/h5/member/educations
修改教育身份	PUT	/h5/member/educations/{educationId}
删除教育身份	DELETE	/h5/member/educations/{educationId}
设置默认教育身份	PUT	/h5/member/educations/{educationId}/default
绑定学生	POST	/h5/member/student
获取绑定的学生列表	GET	/h5/member/students
修改学生信息	PUT	/h5/member/student/{studentId}
解绑学生	DELETE	/h5/member/student/{studentId}
获取操作日志列表	GET	/h5/member/logs

1.3 H5基础数据接口

接口说明	请求方式	接口地址
获取区域树	GET	/h5/base/regions
根据区域获取学校列表	GET	/h5/base/schools
根据学校获取年级列表	GET	/h5/base/grades
根据年级获取班级列表	GET	/h5/base/classes
获取学科列表	GET	/h5/base/subjects

---

二、管理后台接口

2.1 认证接口

接口说明	请求方式	接口地址
获取图形验证码	GET	/auth/code
管理后台登录	POST	/auth/login
退出登录	POST	/auth/logout
用户注册	POST	/auth/register
获取第三方登录跳转URL	GET	/auth/binding/{source}
前端回调绑定授权	POST	/auth/social/callback
取消第三方授权	DELETE	/auth/unlock/{socialId}
获取租户列表	GET	/auth/tenant/list

2.2 验证码接口

接口说明	请求方式	接口地址
发送短信验证码	GET	/resource/sms/code
发送邮箱验证码	GET	/resource/email/code

---

三、业务管理接口

3.1 会员管理

接口说明	请求方式	接口地址
查询会员列表	GET	/business/member/list
获取会员详情	GET	/business/member/{memberId}
新增会员	POST	/business/member
修改会员	PUT	/business/member
删除会员	DELETE	/business/member/{memberIds}
重置会员密码	PUT	/business/member/resetPwd/{memberId}
修改会员状态	PUT	/business/member/changeStatus
检查手机号是否唯一	GET	/business/member/checkPhoneUnique
获取会员已绑定的学生列表	GET	/business/member/{memberId}/students
批量绑定学生到会员	POST	/business/member/{memberId}/bindStudents
解绑学生	POST	/business/member/{memberId}/unbindStudent/{studentId}
获取会员教育身份列表	GET	/business/member/{memberId}/educations
添加教育身份	POST	/business/member/{memberId}/educations
修改教育身份	PUT	/business/member/{memberId}/educations/{educationId}
删除教育身份	DELETE	/business/member/{memberId}/educations/{educationId}
设置默认教育身份	PUT	/business/member/{memberId}/educations/{educationId}/default

3.2 学生管理

接口说明	请求方式	接口地址
查询学生列表	GET	/business/student/list
获取学校树结构	GET	/business/student/schoolTree
获取学生详情	GET	/business/student/{studentId}
新增学生	POST	/business/student
修改学生	PUT	/business/student
删除学生	DELETE	/business/student/{studentIds}
查询可绑定的学生列表	GET	/business/student/available
查询会员已绑定的学生列表	GET	/business/student/byMember/{memberId}
下载学生导入模板	GET	/business/student/template
批量导入学生	POST	/business/student/import

3.3 学校管理

接口说明	请求方式	接口地址
查询学校列表（分页）	GET	/business/school/list
查询学校列表（全部）	GET	/business/school/listAll
获取学校树形结构	GET	/business/school/tree
获取学校详情	GET	/business/school/{schoolId}
新增学校	POST	/business/school
修改学校	PUT	/business/school
删除学校	DELETE	/business/school/{schoolIds}
获取学校的年级列表	GET	/business/school/{schoolId}/grades
获取年级下的班级列表	GET	/business/school/grade/{schoolGradeId}/classes
为学校添加年级	POST	/business/school/grade
为年级添加班级	POST	/business/school/class
删除学校下的年级	DELETE	/business/school/grade/{schoolGradeId}
删除年级下的班级	DELETE	/business/school/class/{schoolClassId}

3.4 区域管理

接口说明	请求方式	接口地址
查询区域列表	GET	/business/region/list
获取区域树	GET	/business/region/tree
获取子区域列表	GET	/business/region/children/{parentId}
获取区域详情	GET	/business/region/{regionId}
获取区域路径	GET	/business/region/{regionId}/path
新增区域	POST	/business/region
修改区域	PUT	/business/region
删除区域	DELETE	/business/region/{regionIds}

3.5 年级管理

接口说明	请求方式	接口地址
查询年级列表（分页）	GET	/business/grade/list
查询年级列表（全部）	GET	/business/grade/listAll
获取年级详情	GET	/business/grade/{gradeId}
新增年级	POST	/business/grade
修改年级	PUT	/business/grade
删除年级	DELETE	/business/grade/{gradeIds}

3.6 班级管理

接口说明	请求方式	接口地址
查询班级列表（分页）	GET	/business/class/list
查询班级列表（全部）	GET	/business/class/listAll
获取班级详情	GET	/business/class/{classId}
新增班级	POST	/business/class
修改班级	PUT	/business/class
删除班级	DELETE	/business/class/{classIds}

3.7 学科管理

接口说明	请求方式	接口地址
查询学科列表（分页）	GET	/business/subject/list
查询学科列表（全部）	GET	/business/subject/listAll
获取学科详情	GET	/business/subject/{subjectId}
新增学科	POST	/business/subject
修改学科	PUT	/business/subject
删除学科	DELETE	/business/subject/{subjectIds}

3.8 第三方应用管理

接口说明	请求方式	接口地址
查询应用列表	GET	/business/application/list
获取应用详情	GET	/business/application/{appId}
新增应用	POST	/business/application
修改应用	PUT	/business/application
删除应用	DELETE	/business/application/{appIds}
重置应用密钥	PUT	/business/application/resetSecret/{appId}
获取API接口列表	GET	/business/application/apiList

3.9 开放API（应用签名鉴权，无需登录）

接口说明	请求方式	接口地址	鉴权说明
学生列表	GET	/open/api/student/list	请求头 X-App-Id、X-Timestamp、X-Sign，且应用需已授权该接口

详见：docs/05-模块技术方案/开放API-学生列表授权-调用测试说明.md

---

四、系统管理接口

4.1 用户管理

接口说明	请求方式	接口地址
获取用户列表	GET	/system/user/list
导出用户列表	POST	/system/user/export
导入用户数据	POST	/system/user/importData
获取导入模板	POST	/system/user/importTemplate
获取当前登录用户信息	GET	/system/user/getInfo
获取用户详情	GET	/system/user/{userId}
新增用户	POST	/system/user
修改用户	PUT	/system/user
删除用户	DELETE	/system/user/{userIds}
批量获取用户基础信息	GET	/system/user/optionselect
重置用户密码	PUT	/system/user/resetPwd
修改用户状态	PUT	/system/user/changeStatus
获取用户授权角色	GET	/system/user/authRole/{userId}
用户授权角色	PUT	/system/user/authRole
获取部门树列表	GET	/system/user/deptTree
获取部门下的所有用户	GET	/system/user/list/dept/{deptId}

4.2 角色管理

接口说明	请求方式	接口地址
获取角色列表	GET	/system/role/list
导出角色列表	POST	/system/role/export
获取角色详情	GET	/system/role/{roleId}
新增角色	POST	/system/role
修改角色	PUT	/system/role
修改数据权限	PUT	/system/role/dataScope
修改角色状态	PUT	/system/role/changeStatus
删除角色	DELETE	/system/role/{roleIds}
获取角色选择框列表	GET	/system/role/optionselect
查询已分配用户列表	GET	/system/role/authUser/allocatedList
查询未分配用户列表	GET	/system/role/authUser/unallocatedList
取消授权用户	PUT	/system/role/authUser/cancel
批量取消授权用户	PUT	/system/role/authUser/cancelAll
批量选择用户授权	PUT	/system/role/authUser/selectAll
获取角色部门树列表	GET	/system/role/deptTree/{roleId}

4.3 部门管理

接口说明	请求方式	接口地址
获取部门列表	GET	/system/dept/list
查询部门列表（排除节点）	GET	/system/dept/list/exclude/{deptId}
获取部门详情	GET	/system/dept/{deptId}
新增部门	POST	/system/dept
修改部门	PUT	/system/dept
删除部门	DELETE	/system/dept/{deptId}
获取部门选择框列表	GET	/system/dept/optionselect

4.4 菜单管理

接口说明	请求方式	接口地址
获取路由信息	GET	/system/menu/getRouters
获取菜单列表	GET	/system/menu/list
获取菜单详情	GET	/system/menu/{menuId}
获取菜单下拉树列表	GET	/system/menu/treeselect
加载角色菜单列表树	GET	/system/menu/roleMenuTreeselect/{roleId}
加载租户套餐菜单列表树	GET	/system/menu/tenantPackageMenuTreeselect/{packageId}
新增菜单	POST	/system/menu
修改菜单	PUT	/system/menu
删除菜单	DELETE	/system/menu/{menuId}
批量级联删除菜单	DELETE	/system/menu/cascade/{menuIds}

4.5 字典类型管理

接口说明	请求方式	接口地址
查询字典类型列表	GET	/system/dict/type/list
导出字典类型列表	POST	/system/dict/type/export
获取字典类型详情	GET	/system/dict/type/{dictId}
新增字典类型	POST	/system/dict/type
修改字典类型	PUT	/system/dict/type
删除字典类型	DELETE	/system/dict/type/{dictIds}
刷新字典缓存	DELETE	/system/dict/type/refreshCache
获取字典选择框列表	GET	/system/dict/type/optionselect

4.6 字典数据管理

接口说明	请求方式	接口地址
查询字典数据列表	GET	/system/dict/data/list
导出字典数据列表	POST	/system/dict/data/export
获取字典数据详情	GET	/system/dict/data/{dictCode}
根据字典类型查询字典数据	GET	/system/dict/data/type/{dictType}
新增字典数据	POST	/system/dict/data
修改字典数据	PUT	/system/dict/data
删除字典数据	DELETE	/system/dict/data/{dictCodes}

4.7 岗位管理

接口说明	请求方式	接口地址
获取岗位列表	GET	/system/post/list
导出岗位列表	POST	/system/post/export
获取岗位详情	GET	/system/post/{postId}
新增岗位	POST	/system/post
修改岗位	PUT	/system/post
删除岗位	DELETE	/system/post/{postIds}
获取岗位选择框列表	GET	/system/post/optionselect
获取部门树列表	GET	/system/post/deptTree

4.8 参数配置管理

接口说明	请求方式	接口地址
获取参数配置列表	GET	/system/config/list
导出参数配置列表	POST	/system/config/export
获取参数配置详情	GET	/system/config/{configId}
根据参数键名查询参数值	GET	/system/config/configKey/{configKey}
新增参数配置	POST	/system/config
修改参数配置	PUT	/system/config
根据参数键名修改参数配置	PUT	/system/config/updateByKey
删除参数配置	DELETE	/system/config/{configIds}
刷新参数缓存	DELETE	/system/config/refreshCache

4.9 通知公告管理

接口说明	请求方式	接口地址
获取通知公告列表	GET	/system/notice/list
获取通知公告详情	GET	/system/notice/{noticeId}
新增通知公告	POST	/system/notice
修改通知公告	PUT	/system/notice
删除通知公告	DELETE	/system/notice/{noticeIds}

---

五、日志监控接口

5.1 操作日志

接口说明	请求方式	接口地址
获取操作日志列表	GET	/monitor/operlog/list
导出操作日志列表	POST	/monitor/operlog/export
删除操作日志	DELETE	/monitor/operlog/{operIds}
清理操作日志	DELETE	/monitor/operlog/clean

5.2 登录日志

接口说明	请求方式	接口地址
获取登录日志列表	GET	/monitor/logininfor/list
导出登录日志列表	POST	/monitor/logininfor/export
删除登录日志	DELETE	/monitor/logininfor/{infoIds}
清理登录日志	DELETE	/monitor/logininfor/clean
账户解锁	GET	/monitor/logininfor/unlock/{userName}

5.3 在线用户

接口说明	请求方式	接口地址
获取在线用户列表	GET	/monitor/online/list
强退用户	DELETE	/monitor/online/{tokenId}
获取当前用户登录设备	GET	/monitor/online
强退当前在线设备	DELETE	/monitor/online/myself/{tokenId}

---

六、接口统计

模块	接口数量
H5认证接口	14
H5会员接口	13
H5基础数据接口	5
管理后台认证接口	10
会员管理	16
学生管理	10
学校管理	13
区域管理	8
年级管理	6
班级管理	6
学科管理	6
第三方应用管理	7
用户管理	16
角色管理	16
部门管理	7
菜单管理	10
字典类型管理	8
字典数据管理	7
岗位管理	8
参数配置管理	9
通知公告管理	5
操作日志	4
登录日志	5
在线用户	4
总计	203*