1.6 KiB
1.6 KiB
| 1 | endpoint | method | description | auth | params | response |
|---|---|---|---|---|---|---|
| 2 | /api/enterprises/list | GET | 获取企业列表（平台管理员） | 需要认证+角色(admin/enterprise) | page, pageSize, keyword, status | 返回企业列表（含企业ID、名称、状态、统计数据等） |
| 3 | /api/enterprises/stats | GET | 获取企业统计（总数、激活数、禁用数、总用户数等） | 需要认证+角色(admin/enterprise) | 无 | 返回企业统计数据 |
| 4 | /api/enterprises/info | GET | 获取企业信息（企业管理员） | 需要认证+角色(多种角色) | 无 | 返回当前企业详细信息 |
| 5 | /api/enterprises/create | POST | 创建企业（平台管理员） | 需要认证+角色(admin/enterprise) | name, short_name, phone, password, email | 返回新创建的企业ID和企业ID字符串 |
| 6 | /api/enterprises/<enterprise_id> | PUT | 更新企业信息（平台管理员） | 需要认证+角色(admin/enterprise) | name, short_name, email, password | 返回更新成功消息 |
| 7 | /api/enterprises/info | PUT | 更新企业信息（企业管理员） | 需要认证+角色(enterprise/admin) | short_name, email | 返回更新成功消息 |
| 8 | /api/enterprises/change-password | PUT | 修改企业密码（企业管理员） | 需要认证+角色(enterprise) | old_password, new_password | 返回密码修改成功消息 |
| 9 | /api/enterprises/<enterprise_id>/status | PUT | 切换企业状态（平台管理员） | 需要认证+角色(admin/enterprise) | status (active/disabled) | 返回操作成功消息 |
| 10 | /api/enterprises/<enterprise_id> | DELETE | 删除企业（平台管理员，物理删除） | 需要认证+角色(admin/enterprise) | enterprise_id (路径参数) | 返回删除成功消息 |