user-center 用户中心
用户中心模块（springdoc 分组 user-center）端点全量清单（107 端点 / 9 资源）。请求规范（鉴权、信封、分页控制字段）见接口规范；逐端点交互调试见 Swagger 视图。
数据源：生产域 api-docs（2026-09-14 现场拉取，https://zxs.netbodycamera.com/main-service/v3/api-docs/）。
本页由脚本生成，不可手改，重跑生成器整体覆盖。
org 组织机构
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/org/count |
count_7 | Swagger |
| GET | /main-service/system-api/user-center/org/getById |
按资源 ID 读取机构详情 | Swagger |
| POST | /main-service/system-api/user-center/org/importList |
从 Web XLSX 行异步导入机构 | Swagger |
| POST | /main-service/system-api/user-center/org/list |
按条件读取机构列表 | Swagger |
| POST | /main-service/system-api/user-center/org/listTree |
listTree_1 | Swagger |
| POST | /main-service/system-api/user-center/org/listTreeCache |
读取供选择器和业务视图使用的机构树 | Swagger |
| POST | /main-service/system-api/user-center/org/page |
按页读取机构列表 | Swagger |
| POST | /main-service/system-api/user-center/org/pageTree |
pageTree_1 | Swagger |
| DELETE | /main-service/system-api/user-center/org/removeById |
删除一个机构 | Swagger |
| DELETE | /main-service/system-api/user-center/org/removeByIds |
一次删除多个机构 | Swagger |
| POST | /main-service/system-api/user-center/org/save |
创建机构 | Swagger |
| PUT | /main-service/system-api/user-center/org/updateById |
更新机构 | Swagger |
tenant 租户
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/tenant/count |
count_6 | Swagger |
| POST | /main-service/system-api/user-center/tenant/countByUsername |
countByUsername | Swagger |
| GET | /main-service/system-api/user-center/tenant/getById |
getById_6 | Swagger |
| POST | /main-service/system-api/user-center/tenant/list |
按条件读取租户列表 | Swagger |
| POST | /main-service/system-api/user-center/tenant/listByUsername |
listByUsername | Swagger |
| POST | /main-service/system-api/user-center/tenant/listByUsernameCache |
listByUsernameCache | Swagger |
| POST | /main-service/system-api/user-center/tenant/listTree |
读取供选择器和业务视图使用的租户树 | Swagger |
| POST | /main-service/system-api/user-center/tenant/listTreeByUsername |
listTreeByUsername | Swagger |
| POST | /main-service/system-api/user-center/tenant/listTreeByUsernameCache |
listTreeByUsernameCache | Swagger |
| POST | /main-service/system-api/user-center/tenant/page |
按页读取租户列表 | Swagger |
| POST | /main-service/system-api/user-center/tenant/pageByUsername |
pageByUsername | Swagger |
| POST | /main-service/system-api/user-center/tenant/pageTree |
pageTree | Swagger |
| POST | /main-service/system-api/user-center/tenant/pageTreeByUsername |
pageTreeByUsername | Swagger |
| DELETE | /main-service/system-api/user-center/tenant/removeById |
删除一个租户 | Swagger |
| DELETE | /main-service/system-api/user-center/tenant/removeByIds |
一次删除多个租户 | Swagger |
| POST | /main-service/system-api/user-center/tenant/save |
创建租户 | Swagger |
| PUT | /main-service/system-api/user-center/tenant/updateById |
更新租户 | Swagger |
third-party-account 第三方账号
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/third-party-account/bind |
把一个第三方账号标识（类型 + 账号）登记到当前登录用户名下，建立「第三方账号 → 平台用户」的绑定关系 | Swagger |
| POST | /main-service/system-api/user-center/third-party-account/count |
count_5 | Swagger |
| GET | /main-service/system-api/user-center/third-party-account/getById |
getById_5 | Swagger |
| POST | /main-service/system-api/user-center/third-party-account/list |
list_5 | Swagger |
| POST | /main-service/system-api/user-center/third-party-account/login |
用已绑定的第三方账号标识（类型 + 账号）免密换取平台登录态：返回加密 JWT（data.authorization）、落定的租户（data.tenantId）与用户资料（data.loginUser） |
Swagger |
| POST | /main-service/system-api/user-center/third-party-account/page |
page_5 | Swagger |
| DELETE | /main-service/system-api/user-center/third-party-account/removeById |
removeById_5 | Swagger |
| DELETE | /main-service/system-api/user-center/third-party-account/removeByIds |
removeByIds_5 | Swagger |
| POST | /main-service/system-api/user-center/third-party-account/save |
save_5 | Swagger |
| PUT | /main-service/system-api/user-center/third-party-account/updateById |
updateById_5 | Swagger |
user 用户
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| PUT | /main-service/system-api/user-center/user/changeBaseInfo |
修改当前登录用户的个人资料（称呼、姓名等） | Swagger |
| PUT | /main-service/system-api/user-center/user/changePassword |
已登录用户验证旧密码后设置新密码 | Swagger |
| PUT | /main-service/system-api/user-center/user/changePasswordById |
changePasswordById | Swagger |
| POST | /main-service/system-api/user-center/user/count |
统计满足条件的用户数量 | Swagger |
| POST | /main-service/system-api/user-center/user/countByTenantId |
countByTenantId | Swagger |
| POST | /main-service/system-api/user-center/user/deactivateWithVerification |
deactivateWithVerification | Swagger |
| PUT | /main-service/system-api/user-center/user/forgetPassword |
forgetPassword | Swagger |
| GET | /main-service/system-api/user-center/user/getBaseInfo |
读取当前登录用户的基础资料（用户名、称呼、头像、手机号、邮箱等） | Swagger |
| GET | /main-service/system-api/user-center/user/getById |
按资源 ID 读取用户详情 | Swagger |
| GET | /main-service/system-api/user-center/user/getRandomNumericByKey |
为手机或邮箱验证码签名取得一次六位随机数；它不是验证码，不能直接用于注册或找回密码 | Swagger |
| POST | /main-service/system-api/user-center/user/list |
按条件读取用户列表 | Swagger |
| POST | /main-service/system-api/user-center/user/listByTenantId |
listByTenantId | Swagger |
| POST | /main-service/system-api/user-center/user/login |
用用户名建立登录态并取得不透明授权 token；不保证 MQTT 已连接或设备可用 | Swagger |
| GET | /main-service/system-api/user-center/user/logind |
用户名族登录态恢复：用当前凭据重新签发 token 并下发登录态视图 | Swagger |
| GET | /main-service/system-api/user-center/user/logout |
注销当前登录会话 | Swagger |
| POST | /main-service/system-api/user-center/user/page |
按页读取用户列表 | Swagger |
| POST | /main-service/system-api/user-center/user/pageByTenantId |
pageByTenantId | Swagger |
| DELETE | /main-service/system-api/user-center/user/removeById |
删除一个用户 | Swagger |
| DELETE | /main-service/system-api/user-center/user/removeByIds |
一次删除多个用户 | Swagger |
| POST | /main-service/system-api/user-center/user/save |
创建用户 | Swagger |
| PUT | /main-service/system-api/user-center/user/switchTenant |
switchTenant | Swagger |
| PUT | /main-service/system-api/user-center/user/updateById |
更新用户 | Swagger |
| POST | /main-service/system-api/user-center/user/uploadAvatar |
上传当前登录用户的头像图片（jpg/png，≤300KB） | Swagger |
| POST | /main-service/system-api/user-center/user/uploadByFileNo |
以「文件号」为键向当前登录用户名下的服务端存储目录上传一个文件，返回该文件的相对路径 | Swagger |
user-email 用户邮箱
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/user-email/count |
count_4 | Swagger |
| GET | /main-service/system-api/user-center/user-email/getById |
getById_4 | Swagger |
| POST | /main-service/system-api/user-center/user-email/list |
list_4 | Swagger |
| POST | /main-service/system-api/user-center/user-email/login |
login_2 | Swagger |
| GET | /main-service/system-api/user-center/user-email/logind |
邮箱族登录态恢复：用当前凭据重新签发 token 并下发登录态视图 | Swagger |
| POST | /main-service/system-api/user-center/user-email/page |
page_4 | Swagger |
| POST | /main-service/system-api/user-center/user-email/register |
register_1 | Swagger |
| DELETE | /main-service/system-api/user-center/user-email/removeById |
removeById_4 | Swagger |
| DELETE | /main-service/system-api/user-center/user-email/removeByIds |
removeByIds_4 | Swagger |
| PUT | /main-service/system-api/user-center/user-email/retrievePassword |
retrievePassword_1 | Swagger |
| POST | /main-service/system-api/user-center/user-email/save |
save_4 | Swagger |
| POST | /main-service/system-api/user-center/user-email/sendVerificationCode |
发送注册、改密、找回或停用所需的邮箱验证码，并轮换下一次签名随机数 | Swagger |
| PUT | /main-service/system-api/user-center/user-email/updateById |
updateById_4 | Swagger |
user-phone-number 用户手机号
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/user-phone-number/count |
count_3 | Swagger |
| GET | /main-service/system-api/user-center/user-phone-number/getById |
getById_3 | Swagger |
| POST | /main-service/system-api/user-center/user-phone-number/list |
list_3 | Swagger |
| POST | /main-service/system-api/user-center/user-phone-number/login |
login_1 | Swagger |
| GET | /main-service/system-api/user-center/user-phone-number/logind |
手机号族登录态恢复：用当前凭据重新签发 token 并下发登录态视图 | Swagger |
| POST | /main-service/system-api/user-center/user-phone-number/page |
page_3 | Swagger |
| POST | /main-service/system-api/user-center/user-phone-number/register |
register | Swagger |
| DELETE | /main-service/system-api/user-center/user-phone-number/removeById |
removeById_3 | Swagger |
| DELETE | /main-service/system-api/user-center/user-phone-number/removeByIds |
removeByIds_3 | Swagger |
| PUT | /main-service/system-api/user-center/user-phone-number/retrievePassword |
retrievePassword | Swagger |
| POST | /main-service/system-api/user-center/user-phone-number/save |
save_3 | Swagger |
| POST | /main-service/system-api/user-center/user-phone-number/sendVerificationCode |
sendVerificationCode | Swagger |
| PUT | /main-service/system-api/user-center/user-phone-number/updateById |
updateById_3 | Swagger |
user-tag 用户标签
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/user-tag/count |
count_2 | Swagger |
| GET | /main-service/system-api/user-center/user-tag/getById |
getById_2 | Swagger |
| POST | /main-service/system-api/user-center/user-tag/list |
list_2 | Swagger |
| POST | /main-service/system-api/user-center/user-tag/page |
page_2 | Swagger |
| DELETE | /main-service/system-api/user-center/user-tag/removeById |
removeById_2 | Swagger |
| DELETE | /main-service/system-api/user-center/user-tag/removeByIds |
removeByIds_2 | Swagger |
| POST | /main-service/system-api/user-center/user-tag/save |
save_2 | Swagger |
| PUT | /main-service/system-api/user-center/user-tag/updateById |
updateById_2 | Swagger |
user-tenant 用户与租户关联
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/user-center/user-tenant/count |
count_1 | Swagger |
| GET | /main-service/system-api/user-center/user-tenant/getById |
getById_1 | Swagger |
| POST | /main-service/system-api/user-center/user-tenant/list |
list_1 | Swagger |
| POST | /main-service/system-api/user-center/user-tenant/page |
page_1 | Swagger |
| DELETE | /main-service/system-api/user-center/user-tenant/removeById |
removeById_1 | Swagger |
| DELETE | /main-service/system-api/user-center/user-tenant/removeByIds |
removeByIds_1 | Swagger |
| POST | /main-service/system-api/user-center/user-tenant/save |
save_1 | Swagger |
| POST | /main-service/system-api/user-center/user-tenant/saveByTenantId |
saveByTenantId | Swagger |
| PUT | /main-service/system-api/user-center/user-tenant/updateById |
updateById_1 | Swagger |
v1-retail 零售接口（v1）
| 方法 | 路径 | 说明 | 详情 |
|---|---|---|---|
| POST | /main-service/system-api/v1/retail/user-center/user/deactivate |
零售 App 账号注销（免验证码，异步受理） | Swagger |
目录