企业内部应用服务端API异步批量同步部门
【摘要】 异步批量同步部门接受部门信息,同步到WeLink通讯录,支持批量更新部门信息,每次请求最多支持10个部门。此接口为异步接口,返回的信息仅表明参数是否合法,是否同步成功请访问 查询部门异步同步结果接口查询 。请求格式说明请求方式:POST (HTTPS)请求地址:https://open.welink.huaweicloud.com/api/contact/v2/departments/bul...
异步批量同步部门
接受部门信息,同步到WeLink通讯录,支持批量更新部门信息,每次请求最多支持10个部门。
此接口为异步接口,返回的信息仅表明参数是否合法,是否同步成功请访问 查询部门异步同步结果接口查询 。
请求格式说明
请求方式:POST (HTTPS)
请求地址:
https://open.welink.huaweicloud.com/api/contact/v2/departments/bulk
认证方式: access_token,请参考获取access_token
请求头部:
Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token
请求参数:
{ "deptInfo": [ { "corpDeptCode": "dddddd", "corpParentCode": "ddfd", "deptNameCn": "生产部门", "deptNameEn": "produce dept", "deptLevel": "1", "managerId": "", "valid": "1", "orderNo": "1000" }, { "corpDeptCode": "dddddd", "corpParentCode": "ddfd", "deptNameCn": "设计部门", "deptNameEn": "design dept", "deptLevel": "1", "managerId": "", "valid": "1", "orderNo": "999" } ] }
请求参数说明:
参数 | 参数类型 | 必填 | 说明 |
---|---|---|---|
corpDeptCode | String | 是 | 客户侧部门唯一编码 |
corpParentCode | String | 是 | 客户侧上一级部门编码。注意:同步1级部门时该字段值设置为“0” |
deptNameCn | String | 是 | 部门中文名称 |
deptNameEn | String | 是 | 部门英文名称 |
deptLevel | String | 是 | 部门级别。1:表示1级部门,2:表示二层部门,以此类推 |
managerId | String | 否 | 部门主管的ID |
valid | String | 是 | 部门状态。1:有效(有效根据是否存在corpDeptCode判断新增还是更新); 0:无效(无效表示已删除) |
orderNo | String | 否 | 部门排序。取值范围:1~999。按数值正序排列。默认为1000。 |
请求示例:
curl -X POST \ 'https://open.welink.huaweicloud.com/api/contact/v2/departments/bulk' \ -H 'Accept-Charset: UTF-8' \ -H 'Content-Type: application/json' \ -H 'x-wlk-Authorization: access_token' \ -d '{"请求参数 json格式"}'
响应格式说明
返回结果:
正常返回结果:
{ "code": "0", "message": "OK", "data": [ { "corpDeptCode": "mmn", "code": "0", "message": "waiting for deal" }, { "corpDeptCode": "lklkl", "code": "47003", "message": "corpDeptCode could not be empty" }, { "corpDeptCode": "mkkknk", "code": "47003", "message": "The department level is empty." } ] }
异常返回结果:
{ "code": "47103", "message": "Authentication failed", "data": [] }
返回参数说明:
参数 | 说明 |
---|---|
code | 数据正常返回“0”,如果发生错误,会返回对应的错误码。 |
message | 返回信息,包括接口请求发生错误时的详细信息。 |
data | corpUserId:该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一); code:状态码; message:状态描述 |
错误码说明:
错误码 | 说明 |
---|---|
0 | 成功 |
47003 | 参数为空(邮箱不能为空,部门信息不能为空等) |
47004 | 参数不对(邮箱格式有误,手机号码有误等) |
47100 | 待处理 |
47101 | Token格式错误 |
47102 | 无权限 |
47103 | Token过期 |
47104 | 处理中 |
47105 | 秘书帐号未创建 |
47106 | 上级部门未创建 |
47107 | 未开户(仅保存成功) |
47108 | 开户中 |
47109 | 开户成功 |
47110 | 开户失败(携带失败原因) |
47111 | 账户不存在 |
47112 | 处理中(无须再提交此数据) |
47113 | 待处理(无须再提交此数据) |
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)