forked from erp-dev/erp
45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
# 快速创建员工用户 API
|
|
|
|
- **URL**: `POST /api/v2/users/quick-create/`
|
|
- **说明**: 一次性创建 Django User 与 `basic_info.Employee` 并建立关联，为前端提供统一的员工开通入口。
|
|
- **权限**: 需要登录（任意已绑定员工的用户）。
|
|
|
|
## 请求体
|
|
|
|
| 字段 | 类型 | 必填 | 说明 |
|
|
|------|------|------|------|
|
|
| `username` | string | 是 | 登录名，全局唯一 |
|
|
| `password` | string | 是 | 至少 6 位密码 |
|
|
| `display_name` | string | 是 | 员工姓名，同时写入 User.first_name |
|
|
| `merchant_id` | int | 是 | 员工所属商户 |
|
|
| `email` | string | 否 | 邮箱 |
|
|
| `mobile` | string | 否 | 联系电话 |
|
|
| `area` | string | 否 | 区域信息 |
|
|
| `description` | string | 否 | 备注 |
|
|
| `status` | enum | 否 | 员工状态，默认 `active` |
|
|
|
|
## 响应示例
|
|
|
|
```json
|
|
{
|
|
"user": {
|
|
"id": 12,
|
|
"username": "new_user",
|
|
"display_name": "新员工"
|
|
},
|
|
"employee": {
|
|
"id": 45,
|
|
"name": "新员工",
|
|
"status": "active",
|
|
"merchant": 3
|
|
}
|
|
}
|
|
```
|
|
|
|
## 失败响应
|
|
|
|
- `400 用户名已存在`
|
|
- `400 商户不存在`
|
|
- `401 未认证`
|
|
|