创建用户

接口说明：在EIMSNext系统中创建新用户，需携带有效Token且拥有用户管理权限。

1. 接口信息

参数 说明
请求方式 POST
接口地址 /api/v1/users
是否需要授权 是
请求格式 JSON

2. 请求参数

2.1 Header参数

参数名 必选 类型 说明
Authorization 是 string Bearer + Token
Content-Type 是 string application/json

2.2 Body参数

参数名 必选 类型 说明
userName 是 string 用户名
mobile 是 string 手机号（唯一）
email 否 string 邮箱
password 是 string 密码（MD5加密）
deptId 是 string 部门ID
position 否 string 职位
status 否 int 状态：1-启用（默认），2-禁用

3. 请求示例

POST /api/v1/users HTTP/1.1
Host: eimsnext.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
  "userName": "王五",
  "mobile": "13700137000",
  "email": "wangwu@example.com",
  "password": "e10adc3949ba59abbe56e057f20f883e",
  "deptId": "D001",
  "position": "后端开发",
  "status": 1
}

4. 响应结果

4.1 成功响应

200 OK

{
  "code": 200,
  "msg": "创建成功",
  "data": {
    "userId": "10003"
  }
}

4.2 失败响应

400 Bad Request

{
  "code": 400,
  "msg": "手机号已存在",
  "data": null
}

5. 错误码说明

错误码 说明 解决方案
401 Token无效或过期 重新获取Token
403 无创建用户权限 分配用户管理权限
400 参数错误/手机号重复 检查参数或更换手机号
500 服务器内部错误 联系技术支持

6. 注意事项