-
当企业有待办应用,但企业无对应的We码小程序处理“待办”业务时,Workplace支持企业通过H5页面来处理“待办”,企业需提供TaskList接口。接口说明接口名称: (如:待办消息详情查询接口)请求方式: GET认证方式: 接口验签请求地址: http://www.test.com/api/v1/tasklist请求参数说明:参数名称是否传递参数说明uid是用户ID。如zhangsan@welinktimestamp是时间戳。系统当前时间戳13位,如1555000000123nonce是随机数。 如52673appname是调用taskList的时候,会传递该参数,待办服务根据该参数查询当前应用的任务清单。如todo1signature是待办中心的生成的签名。待办服务自签名后与此对比,完成请求合法性校验。如:976e8f40f3be..省略..type否调试与验证时会传递该参数,仅用于验证服务是否正常。 值为test。响应格式说明返回结果:TaskList 数据结构定义{ "taskList": [ { "taskDesc": "B todo task description", // 任务描述信息 "time": "2018-06-15 10:27:29", //最近申请人的申请时间 "applicant": "lisi@welink", //最近申请人userId "taskURL": "https://task.test.com/app1/xxx", //H5待办处理页面1 "appName": "B_application_todo" }, { "taskDesc": "B todo task description", // 任务描述信息 "time": "2018-06-15 10:27:29", //最近申请人的申请时间 "applicant": "wangwu@welink", //最近申请人userId "taskURL": "https://task.test.com/app1/xxx", //H5待办处理页面2 "appName": "B_application_todo" } ], "status": "1", "msg": "okay"}空数据返回:{ "taskList": [], "status": "1", "msg": "okay"}返回参数说明:参数说明taskList返回任务的信息列表:taskDesc:任务描述信息time:最近申请人的申请时间applicant:最近申请人userIdtaskURL:H5待办处理页面appName:应用名称status返回状态。msg返回信息,包括接口请求发生错误时的详细信息。
-
当使用企业自建的We码小程序处理“待办”业务时,企业需提供AppList接口。接口说明接口名称: (如:待办消息应用查询接口)请求方式: GET请求地址: http://www.test.com/api/v1/applist认证方式: 接口验签请求参数说明:参数名称是否传递参数说明uid是用户ID。如zhangsan@welinktimestamp是时间戳。系统当前时间戳13位,如1555000000123。nonce是随机数。如52673。signature是待办中心的生成的签名。待办服务自签名后与此对比,完成请求合法性校验。如:976e8f40f3be..省略..type否调试与验证时会传递该参数,仅用于验证服务是否正常。值为test。响应格式说明返回结果:AppList结构定义:{ "appList": [ { "appName": "A_application_todo", //A应用名称 "time": "2018-06-15 10:27:29", //最近申请人的申请时间 "appNum": "3", //电子流的数目 "applicant": "zhangsan@welink", //最近申请人userId "appURL": "h5://A_application_todo/xxx/html/index.html" //A应用微码移动审批处理页面 }, { "appName": "B_application_todo", //B应用名称 "time": "2018-06-15 10:27:29", //最近申请人的申请时间 "appNum": "1", //电子流的数目 "applicant": "lisi@welink", //最近申请人userId "appURL": "" //不传URL路径,则表示无对应的微码应用,待办服务将采用默认应用列表打开H5页面 } ], "status": "1", "msg": "okay"}空数据返回:{ "appList": [], "status": "1", "msg": "okay"}返回参数说明:参数说明appList返回待办应用的信息列表:appName:应用名称time:最近申请人的申请时间appNum:电子流的数目applicant:最近申请人userIdappURL:应用微码移动审批处理页面。不传URL路径,则表示无对应的微码应用,待办服务将采用默认应用列表打开H5页面。status返回状态。msg返回信息,包括接口请求发生错误时的详细信息。
-
说明:获取到参数后将uid进行urldecode,再对原始的uid进行md5,然后生成字符串。plain = md5(uid)+timestamp+nonce为了保证安全,待办服务还可以加上时间戳限制,如时间差低于60秒则返回数据。使用租户密钥加密plain,生成企业自签名signature1与signature对比,对比合法则查询uid待办记录并返回数据。注意:如果调用taskList接口,请求服务会多传一个参数appname,appname的处理方式和uid一致,需要urldecode并md5,此时验签plain如下: plain = md5(appname)+md5(uid)+timestamp+noncejava验签计算Demoprivate String createSignature(String plain, String secretKey) { try { // url encode String paramEncode = URLEncoder.encode(plain, "UTF-8"); // hmac-sha1加密 Mac mac = Mac.getInstance("HmacSHA1"); SecretKeySpec spec = new SecretKeySpec(secretKey.getBytes("UTF-8"), "HmacSHA1"); mac.init(spec); byte[] byteHMAC = mac.doFinal(paramEncode.getBytes("UTF-8")); return new String(Hex.encodeHex(byteHMAC)); } catch (InvalidKeyException | UnsupportedEncodingException | NoSuchAlgorithmException e) { logger.info("HMAC-SHA1签名异常" + e.getMessage()); return null; } }
-
概述数据不落地的方式是指WeLink调用开发者应用提供的接口,获取当前用户的待办事项。接口触发的条件为用户打开手机端, 需要注意的事,如果用户已经处理了该待办,应用接口应妥善处理事件信息,否则用户手机端将持续展示该事件。 介绍We码小程序如何使用WeLink的“业务-待办” 能力。仅用于企业自建系统待办集成。术语解释以下"待办中心"指的是WeLink待办中心,"待办服务"指的是由企业提供的待办服务。WeLink待办中心简介本文提到的待办卡片组成有三部分:1、来自客户端内置应用,如请假We码小程序。 2、来自企业自建的We码小程序。 3、来自企业自有的H5应用。普通用户打开手机APP,切换到"业务" 页签,可进行待办处理(图1),没有待办时该卡片为空;如果有待办,且企业开发了We码小程序应用,那么点击待办应用的时候,会直接打开We码小程序应用(图2);如果企业没有开发We码小程序,那么将用内置任务列表的方式打开(图3)。从左往右分别是图1、图2、图3:WeLink待办中心服务场景介绍目前同时支持以下两种场景:企业待办集成流程图接入限制WeLink待办中心网络出口当前支持80和443端口。“待办服务”使用流程签名算法介绍AppList接口(可选)TaskList接口 :当客户端无内置且企业无自建的“待办”应用时,需提供该接口。服务注册指导调试与验证
-
撤销(或完成)指定电子流当某个电子流发生撤销或者整个电子流所有环节都完成后,调用此接口。请求格式说明请求方式: DELETE(HTTPS)认证方式: access_token,请参考获取access_token请求地址: https://open.welink.huaweicloud.com/api/todo/v1/deltask请求头部:x-wlk-Authorization:access_token请求参数说明:参数参数类型说明是否必填taskIdstring租户应用任务id是请求示例:curl –X DELETE 'https://open.welink.huaweicloud.com/api/todo/v1/deltask?taskId=5' -H 'x-wlk-Authorization: access_token'响应格式说明正常返回结果:{ "code": "0", "message": "Delete todo task successfully.", "data": true}异常返回结果:{ "code": "55002", "message": "You haven't the permission to request this operation.", "data": "You haven't the permission to request this operation."}错误码说明:参数说明code响应编码0:成功 55009:Delete todo task failed.55002:You haven't the permission to request this operation55006:Request parameters validate failed.55005:the client missing required parameters.55000:authorazation failed.55004:server exception.message错误消息datatrue:更新成功 false:无更新记录或更新失败
-
结束指定电子流的指定用户的待办当电子流的某一个人完成了其审批任务,调用此接口,结束其待办任务通知。请求格式说明请求方式: PUT(HTTPS)认证方式: access_token,请参考获取access_token请求地址: https://open.welink.huaweicloud.com/api/todo/v1/updatetask请求头部:x-wlk-Authorization:access_token请求参数说明:参数参数类型说明是否必填taskIdstring租户应用任务id是userIdstring任务的当前处理人账号是请求示例:curl –X PUT 'https://open.welink.huaweicloud.com/api/todo/v1/updatetask?taskId=5&userId=todo20190725889' -H 'x-wlk-Authorization: access_token'响应格式说明正常返回结果:{ "code": "0", "message": "Update todo task successfully.", "data": true}异常返回结果:{ "code": "55002", "message": "You haven't the permission to request this operation.", "data": "You haven't the permission to request this operation."}错误码说明:参数说明code响应编码0:成功 55008:Update todo task failed.55002:You haven't the permission to request this operation55006:Request parameters validate failed.55005:the client missing required parameters.55000:authorazation failed.55004:server exception.message错误消息datatrue:更新成功 false:无更新记录或更新失败
-
数据落地的方式是指开发者的应用通过调用WeLink提供的待办接口将待办数据推送到WeLink,需要注意的事,如果用户已经处理了该待办,应用需要及时将相关信息推送到WeLink,否则用户手机端将持续展示该事件。 开发者通过以下API可以将业务系统中用户待办推送的手机端并展示。效果如下:需要注意的是,如果一个待办任务超过3个月未更新,系统将删除此项待办。新增单个待办任务。请求格式说明请求方式: POST(HTTPS)认证方式: access_token,请参考获取access_token请求地址: https://open.welink.huaweicloud.com/api/todo/v1/addtask请求头部:x-wlk-Authorization:access_token请求参数:{ "taskId": "5", "taskTitle": "todo20190725889", "userId": "yewei@weiying.com", "detailsUrl": "https://example.com/app/detail/5", "appName": "todo2019073001", "taskDesc": "todo20190725889描述1", "applicantUserId": "test", "applicantUserNameCn": "testCN", "applicantUserNameEn": "testEN"}请求参数说明:参数参数类型说明是否必填taskIdstring租户应用任务id是taskTitlestring审批任务标题否userIdstring任务的当前处理人账号是detailsUrlstring消息处理路径是appNamestring应用名称是taskDescstring审批任务内容否applicantUserIdstring申请人id是applicantUserNameCnstring申请人中文名称是applicantUserNameEnstring申请人英文名称是请求示例:curl -X POST \ ' https://api.cloudlink-alpha.welink.huawei.com/kmiddle/api/todo/v1/addtask’\ -H 'Accept-Charset: UTF-8' \ -H 'Content-Type: application/json' \ -H 'x-wlk-Authorization: access_token' \ -d '{"请求参数 json格式"}'响应格式说明正常返回结果:{ "code": "0", "message": "Create todo_task successfully.", "data": { "taskId": "4", "uuid": "374731891993001984", "taskTitle": "todo2019073004", "userId": "wissng", "userName": "wssg", "detailUrlType": "h5", "status": 1, "detailsUrl": "https://welink.example.cn/todo/v1/appList", "appName": "todo2019073004", "lastModifyTime": "2019-12-01 18:00:00", "createTime": "2019-12-01 18:00:00", "taskDesc": "todo2019073004", "tenantId": "8C109D2A76604639BAAA582C75779WDS", "applicantUserId": "yewei@weiying", "applicantUserNameCn": "yewei", "applicantUserNameEn": "weiye" } }异常返回结果:{ "code": "55002", "message": "You haven't the permission to request this operation.", "data": "You haven't the permission to request this operation."}错误码说明:参数说明code响应编码0:成功55007:创建待办失败55002:没有操作权限55006:请求参数验证不通过55005:缺失必填参数55000:认证失败55004:服务异常message错误消息data响应具体内容
-
响应格式是data boolean, 今天再次请求时,响应变成了修改API不更新文档吗?
-
该接口用于企业考勤系统接入使用,用于返回企业内部员工全部的打卡结果。当前仅支持通过员工工号的方式去查询考勤相关数据。接口目前仅返回一些考勤相关数据,不包含考勤是否异常;是否是法定假日加班等考勤处理数据。需要企业由接收数据的系统服务端自行处理。请求格式说明请求方式: POST(https)认证方式: access_token,请参考获取access_token请求地址: https://open.welink.huaweicloud.com/api/attendance/v2/records原V1接口仍然支持。请求头部:x-wlk-Authorization: access_token Content-Type:application/json请求参数:{ "offset": 0, "userIdList": ["w00123456", "w00123456"], "dateFrom": "yyyy-mm-dd hh:mm:ss", "dateTo": "yyyy-mm-dd hh:mm:ss", "limit": 50}请求参数说明:参数参数类型必填说明offsetInt是表示获取考勤数据的起始点第一次传0,如果还有多余数据,下次获取传的1、2...依次递增userIdListList否此处userIdList指的是员工企业标识,员工企业标识需要在管理后台维护才可以查询,员工在企业内的员工工号列表,最多不能超过50个;如果没有维护员工企业标识,传递[],即默认获取全员当天的考勤数据dateFromString是查询考勤打卡记录的起始工作日。dateToString是查询考勤打卡记录的结束工作日。注意,起始与结束工作日最多相隔24小时limitint是表示获取考勤数据的条数,最大不能超过100条请求示例:url -X POST \ https://open.welink.huaweicloud.com/api/attendance/v1/records \ -H 'Content-Type: application/json' \ -H 'x-wlk-Authorization: access_token' \ -d '{ "offset": 0, "userIdList": ["员工工号1", "员工工号2"], "dateFrom": "yyyy-mm-dd hh:mm:ss", "dateTo": "yyyy-mm-dd hh:mm:ss", "limit": 100}'响应格式说明返回结果:{ "code": "0", "message": "ok", "totalCount": 32700, "limit": 50, "offset": 100, "records": [ { "id": "0170845db557459785522393192015ea", "userId": "xxx@cloudlink", "corpUserId": "1234567", "userNameCn": "测试", "checkTime": "2018-08-02 17:31:34", "location": "天安云谷", "longitude":"114.066873", "latitude":"22.650278" }, { "id": "9719982fffe54ff899e197b7281df26d", "userId": "xxx@cloudlink", "corpUserId": "1234567", "userNameCn": "测试", "checkTime": "2018-08-02 17:31:33", "location": "天安云谷", "longitude":"114.066873", "latitude":"22.650278" } ] }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码message返回信息,包括接口请求发生错误时的详细信息totalCount总的数据条目limit每次返回的数据量offset数据偏移量即页码records打卡数据id打卡记录的唯一id信息corpUserId该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一)userId用户的工号信息userNameCn用户的中文名字checkTime打卡时间location打卡地点longitude打卡的经度latitude打卡的纬度错误码说明:错误码说明56100ok56101接口参数缺少或参数类型错误56102查无数据56104认证信息为空或无效56105服务器内部错误
-
消息示例以及消息功能的补充说明。消息示例文本消息模板示例推送消息实现免登在正式的场景中,一般推送给用户的待办消息或者通知消息,用户点击打开Web页面后需要实现免登录。推送消息跳转到We码小程序如果已经开发了微码应用,且推送的消息有对应的微码应用可以进入处理,例如:已经开发了差旅申请的微码应用,用户收到一个差旅审批的通知后,点击通知可以直接打开差旅申请进行审批操作。只需配置微码的页面如下:"urlType":"html""urlPath":"h5://{client_id}/html/index.html"可以指向We码小程序首页,也可以根据你的实际场景指向对应的处理页面如detail.html: h5://{client_id}/html/detail.html。
-
该接口用于企业应用中需要消息通知的场景。通过本接口,应用可以将信息推送给WeLink端用户。接口说明请求方式: POST(HTTPS)请求地址: https://open.welink.huaweicloud.com/api/messages/v3/send认证方式: access_token,请参考获取access_token原V1、V2接口可以继续使用,但不推荐,文档不再体现。请求头部:Content-Type: application/json x-wlk-Authorization: access_token请求参数: { "msgRange": 0, "toUserList": ["john@welink", "john@1234"], "msgTitle": "{\"EN\": \"hello world\", \"CN\": \"你好\"}", "msgContent": "{\"CN\": \"欢迎使用\", \"EN\":\"Welcome\"}", "urlType": "html", "urlPath": "h5://demo.com", "msgOwner": "John", "createTime": "1487289600000"}请求参数说明:参数参数类型必填说明toUserListList是成员ID列表(消息接收者,多个接收者用','分隔,最多支持1000个)。msgRangeString是0:按用户推送msgTitleString是标题,不超过128个字节,超过会自动截断,如果不需要双语,可直接传string如“出差电子流” ,需要双语则参考请求包体示例,传入{json}string对象。msgContentString是描述,不超过512个字节,超过会自动截断,如果不需要双语,可直接传string如“张三提交了一个去上海的出差申请” ,双语场景同上。urlTypeString是链接类型定义,如"html",则可跳转到http://url地址。urlPathString是点击后跳转的链接,如需要跳转到微码,参考推送消息实现免登。msgOwnerString是消息所有者,如“差旅管理”。createTimeString否消息创建时间,可不传系统将自动生成推送时间。msgDisplayModeint否非必填,默认0表示支持手机链接和PC链接,配置为1时仅移动端显示desktopUrlPathString否非必填,当msgDisplMode配置为0时,需要配置该参数,如果不配置那就默认使用urlPath请求示例: curl -X POST \ 'https://open.welink.huaweicloud.com/api/messages/v3/send?=' \ -H 'Content-Type: application/json' \ -H 'x-wlk-Authorization: access_token' \ -d '{"请求参数 json格式"}'响应格式说明正常返回结果:{ "code":"0", "message":"ok"}异常返回结果:{ "code":"51019", //错误码 "message":"用户未关注或者推送账号不存在", //错误提示 "failedUserId":["zhangsan@welink", "lisi@welink"] //因为userId推送失败,会显示失败人员信息}返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。failedUserId推送失败的userId错误码说明:错误码说明51002推送消息异常51003没有传入公众号ID51010该公众号在系统中不存在51018单次发送用户数最大1000人51019不能给非粉丝用户推送消息51036用户未登录51042用户列表不能为空
-
查询异步批量同步部门的结果。请求格式说明请求方式:POST (HTTPS)请求地址:https://open.welink.huaweicloud.com/api/contact/v2/departments/status 认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数: { "deptInfo": [ { "corpDeptCode": "L1" }, { "corpDeptCode": "L2" } ] }请求参数说明: 参数参数类型必填说明corpDeptCodeString是客户侧部门唯一编码请求示例: curl -X POST \ 'https://open.welink.huaweicloud.com/api/contact/v2/departments/status' \ -H 'Accept-Charset: UTF-8' \ -H 'Content-Type:application/x-www-form-urlencoded' \ -H 'x-wlk-Authorization: access_token' \ -d '{"请求参数 json格式"}'响应格式说明返回结果:正常返回结果:{ "code": "0", "message": "ok", "data": [ { "corpDeptCode": "1001", " code": "47119", "message": "OK" }, { "corpDeptCode": "1002", "code": "47118", "message": "The department is processing." }, { "corpDeptCode": "1003", "code": "47114", "message": "The department is processed unsuccessfully." } ] }异常返回结果:{ "code": "47101", "message": "token格式错误", "data": [] }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。datacorpDeptCode:企业部门唯一标识(客户内唯一);code:状态码;message:状态描述错误码说明:错误码说明0成功47003参数为空(邮箱不能为空,部门信息不能为空等)47004参数不对(邮箱格式有误,手机号码有误等)47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书帐号未创建47106上级部门未创建47107未开户(仅保存成功)47108开户中47109开户成功47110开户失败(携带失败原因)47111账户不存在47112处理中(无须再提交此数据)47113待处理(无须再提交此数据)
-
接受部门信息,同步到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", "visibleRange": 2 } ] }请求参数说明: 参数参数类型必填说明corpDeptCodeString是客户侧部门唯一编码corpParentCodeString是客户侧上一级部门编码。注意:同步1级部门时该字段值设置为“0”deptNameCnString是部门中文名称deptNameEnString是部门英文名称deptLevelString是部门级别。1:表示1级部门,2:表示二层部门,以此类推managerIdString否部门主管的IDvalidString是部门状态。1:有效(有效根据是否存在corpDeptCode判断新增还是更新);0:无效(无效表示已删除)orderNoString否部门排序。取值范围:1~999。按数值正序排列。默认为1000。visibleRangeInt否1、全部可见 2、仅自己可见 3、当前部门和子部门可见请求示例: 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返回信息,包括接口请求发生错误时的详细信息。datacorpDeptCode:企业部门唯一标识(客户内唯一);code:状态码;message:状态描述错误码说明:错误码说明0成功47003参数为空(邮箱不能为空,部门信息不能为空等)47004参数不对(邮箱格式有误,手机号码有误等)47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书帐号未创建47106上级部门未创建47107未开户(仅保存成功)47108开户中47109开户成功47110开户失败(携带失败原因)47111账户不存在47112处理中(无须再提交此数据)47113待处理(无须再提交此数据)
-
根据部门编码查询子部门信息。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v2/departments/list认证方式: access_token,请参考获取access_token请求头部:x-wlk-Authorization: access_token请求参数: 参数必填说明deptCode是部门编码,示例:0recursiveflag是0 :查询下级部门信息1 :查询递归获取所有子部门offset是当前页,默认值是1limit是每页数量,默认值是100,最大限制每页100遍历说明:1.由于初级部门编码一般为0,因此可设置deptCode=0,recursiveflag=0,获取一层组织编码(注意一级部门不支持直接遍历)。如得到一层部门编码为deptCode:1000; 2.查询1000的下一层部门,可设置deptCode=1000, recursiveflag=0; 3.如果需要查询1000下的所有部门,设置deptCode=1000, recursiveflag=1。请求示例:curl -H 'x-wlk-Authorization: access_token' https://open.welink.huaweicloud.com/api/contact/v2/departments/list?deptCode=0&recursiveflag=0&offset=1&limit=100响应格式说明返回结果: { "code": "0", "message": "OK", "offset": 100, "limit": 25, "totalCount": 327, "departmentInfo": [ { "deptCode": "1", "deptNameCn": "产品销售部", "deptNameEn": "Sales Dept", "fatherCode": "0", "deptLevel": "2", "orderNo": 1 }, { "deptCode": "2", "deptNameCn": "产品研发部", "deptNameEn": "Products Dept", "fatherCode": "0", "deptLevel": "2", "orderNo": 2 }, { // 更多部门 } ] }返回参数说明:参数说明code数据正常返回“0”,如果发生错误,会返回对应的错误码。message返回信息,包括接口请求发生错误时的详细信息。totalCount当前部门下所有部门数,如果当前部门为0级,仅能获取下一级的所有部门。deptCode部门编码,如1。deptNameCn部门名称中文。deptNameEn部门名称英文。fatherCode上一个层级部门编码。deptLevel组织层级编码,如XX公司是组织层级是0,XX公司->研发部 则研发部层级是1。orderNo部门排序,该字段在部门维护时设定的,如果不维护则默认为1000。错误码说明:参数名参数类型是否必填参数含义codeint是错误码:>> 0 : OK>> 47000 : 无权限>> 47001 : 当前登陆用户信息获取失败>> 47002 : 部门编码为空>> 47003 : 参数为空>> 47004 : 参数不对>> 47007 : 当前登陆者是非法用户或个人详情已失效>> 47008 : 参数校验不通过>> 47009 : 提交失败>> 47012 : 无数据>> 47013 : 查询数量限制>> 47100 : 待处理>> 47101 : Token格式错误>> 47102 : 无权限>> 47103 : Token过期>> 47104 : 处理中>> 47105 : 秘书账号未创建>> 47106 : 上级部门未创建>> 500 : 系统错误messagestring是错误信息
-
根据部门编码获取当前部门的所有上级父部门信息。如三级部门C的上级部门为二级部门B和一级部门A,则部门编码输入C,返回所有上级父部门路径A>>B>>C。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/department/parent认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-8 Content-Type:application/json x-wlk-Authorization:access_token请求参数说明: 参数名参数说明类型必选deptCode部门编码。从用户详细信息中获取部门编码。string是请求示例:curl -X GET "https://open.welink.huaweicloud.com/api/contact/v1/department/parent?deptCode=2000" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"响应格式说明正常返回结果: { "code": "0", "message": "OK", "data": [ { "deptAllCode": "1003>>2003>>3003", //所有上级部门Id, 必填 "deptAllNameCn": "一级部门>>二级部门>>测试本部门", //所有上级部门中文名称 "deptAllNameEn": "1stDeptName>>2ndDeptName>>TestDeptName" //所有上级部门英文名称 } ] }异常返回结果 { "code": 47101, "message": "Token格式错误", "data": [] }返回参数说明:参数名必选类型参数说明code是string数据正常返回“0”,如果发生错误,会返回对应的错误码message是string返回信息,包括接口请求发生错误时的详细信息data否array部门路径信息:>> deptAllCode: 部门路径编码>> deptAllNameCn: 部门路径中文名称>> deptAllNameEn: 部门路径英文名称错误码说明:错误码说明47000无权限47001当前登录用户信息获取失败47002部门编码为空47003参数为空47004参数不对47007当前登录者是非法用户或个人详情已失效47008参数校验不通过47009提交失败47012无数据47013查询数量限制47100待处理47101Token格式错误47102无权限47103Token过期47104处理中47105秘书账号未创建47106上级部门未创建500系统错误
上滑加载中
推荐直播
-
华为云IoT开源专家实践分享:开源让物联网平台更开放、易用
2024/05/14 周二 16:30-18:00
张俭 华为云IoT DTSE技术布道师
作为开发者的你是否也想加入开源社区?本期物联网平台资深“程序猿”,开源专家张俭,为你揭秘华为云IoT如何借助开源构建可靠、开放、易用的物联网平台,并手把手教你玩转开源社区!
去报名
热门标签