更新成员接口
请求说明
HTTP请求方式:POST
base_url:
https://www.feeclouds.com
API:
/api/v2/user/edit
请求参数格式:
form-data
参数说明
参数 | 参数类型 | 必须 | 说明 |
---|---|---|---|
company_key | str | 是 | 费耘系统提供的企业company_key |
nonce_str | str | 是 | 6位随机字符串 |
sign | str | 是 | 根据签名生成规则生成的签名 |
targets | list | 是 | 由以下字段组成的字典形成的列表 注:不修改的参数,请勿在targets中写入! |
targets的list中包含以下字段 | |||
user_id | str | 是 | 成员id |
department_ids | str | 是 | 成员部门id。 字段"role"为"5"时,可输入多个,格式为:id之间使用逗号隔开,如:department_ids = "xxx,xxx,xxx" 注:需要输入该成员全部原部门id |
target_department_ids | str | 否 | 成员要调整到的部门id 角色"role"为"5"时,可输入多个,格式为:id之间使用逗号隔开,如:target_department_ids = "xxx,xxx,xxx" 注:多个id对应多个分公司,不可在同一个分公司下有多个id,即成员在仅可在同一分公司下的一个部门。 |
is_login | int | 否 | 是否允许该成员登录费耘(Web、APP、小程序) 0:禁止登录,1:允许登录 注:值为 0 时,参数"role"的值只能为"1" |
role | str | 否 | 成员角色 1:员工,2:管理员,4:财务,5:多公司员工 注:仅支持集团下"多公司员工"角色的更新 |
username | str | 否 | 成员登录邮箱 |
realname | str | 否 | 成员姓名 |
password | str | 否 | 用户登录密码 |
is_link | str | 否 | 在职状态 0:离职,1:在职 |
number | str | 否 | 员工编码 |
请求参数示例
targets: [{
"user_id": "44dd7bf0d9794ac480d83bdd0d78e0ec",
"department_id": "6c2c924eb0754282b45a00c43195d11a",
"is_link": "1",
"username": "zhangsan@abc.com",
"password": "123456",
"realname": "ZS",
"role": "2"
},
{
"user_id": "44dd7bf0d9794ac480d83bdd0d78e0ec",
"department_id": "6c2c924eb0754282b45a00c43195d11a",
"target_deaprtment_id": "9b2c924eb0754282b45a00c78291d02a",
"is_link": "1",
"role": "4",
"is_login": 1
},
{
"user_id": "44dd7bf0d9794ac480d83bdd0d78e0ec",
"department_id": "6c2c924eb0754282b45a00c43195d11a",
"target_deaprtment_id": "8a979824e89ce4282b45a09d848759923",
"is_link": "1",
"username": "lisi@abc.com",
"role": "4",
"is_login": 1
}
]
返回结果
返回成功json示例
{
"code": 0,
"msg": "成功",
"data": None
}
更新说明
更新的targets中若有无法更新的数据(例如: user不存在, department不存在),则全部targets都不更新