新增人员账号(API名称:person/add)
请求URL
POST /api/person/add
参数名 | 是否必须 | 类型 | 描述 |
name | 是 | string | 新增人员的姓名 |
是 | string | 新增人员的邮箱地址 | |
phone | 否 | string | 新增人员的联系电话 |
role | 是 | string | 新增人员的角色 |
department | 是 | string | 新增人员所在的部门 |
请求示例
{ "name": "张三", "email": "zhangsan@example.com", "role": "工程师", "department": "技术部" }
参数名 | 是否必须 | 类型 | 描述 |
code | 是 | int | 响应状态码,200表示成功,其他值表示失败 |
message | 是 | string | 响应消息,成功时为"success",失败时为具体的错误信息 |
data | 否 | object | 响应数据,成功时包含新增人员的信息,失败时为空 |
响应示例
{ "code": 200, "message": "success", "data": { "id": 1, "name": "张三", "email": "zhangsan@example.com", "role": "工程师", "department": "技术部" } }
参数名称 | 数据类型 | 是否必填 | 描述 |
username | string | 是 | 用户名,唯一标识符 |
password | string | 是 | 密码 |
name | string | 是 | 人员姓名 |
string | 否 | 电子邮箱地址 | |
phone | string | 否 | 联系电话 |
department | string | 否 | 所属部门 |
position | string | 否 | 职位 |
role | string | 是 | 用户角色(如:管理员、普通用户等) |
status | string | 是 | 账号状态(如:启用、禁用等) |
此介绍中的参数根据常见的用户账号信息设计,具体参数可以根据实际API需求进行调整,每个参数的描述简要说明了其用途,是否必填表示在调用API时该参数是否必须提供。