部门
根据第三方部门Id获取部门信息
鉴权方式
HAP 组织授权开放接口为每个组织提供一套独立的密钥信息(AppKey 和 SecretKey),组织可通过此密钥信息安全调用 HAP 平台开放的各类接口,包括人员组织管理、汇报关系管理、应用管理、流程待办等数据接口。
版本
请求地址
Query 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
appKey | string | 是 | AppKey |
sign | string | 是 | 签名 |
timestamp | integer | 是 | 时间戳 |
projectId | string | 是 | HAP组织Id |
corpDepartmentId | string | 是 | 第三方部门Id |
isNumber | boolean | 否 | corpDepartmentId 是否是数值类型(如果是基于企微/钉钉/Welink集成的环境,需传true) |
响应参数
200| 名称 | 类型 | 描述 |
|---|---|---|
code | integer | 状态码,1表示操作完成;非1表示操作异常,非1时data字段不存在 |
message | string | 状态描述 |
data | object | 部门信息 |
data.corpDepartmentId | string | 第三方部门Id |
data.projectId | string | HAP组织Id |
data.departmentId | string | HAP部门Id |
data.departmentName | string | HAP部门名称 |
data.parentDepartmentIdPaths | string[] | HAP父级部门路径Id列表:[“一级父部门Id”, “二级父部门Id”, … , “最高级部门Id”] |
data.parentCorpDepartmentIdPaths | string[] | 第三方父级部门路径Id列表:[“一级父部门Id”, “二级父部门Id”, … , “最高级部门Id”] |
data.childDepartmentIds | string[] | HAP一级子部门Id列表 |
data.childCorpDepartmentIds | string[] | 第三方一级子部门Id列表 |
curl -X GET "https://example.com/v2/department/getDepartmentByCorpDepartmentId?appKey=string&sign=string×tamp=0&projectId=string&corpDepartmentId=string"{ "code": 0, "message": "string", "data": { "corpDepartmentId": "string", "projectId": "string", "departmentId": "string", "departmentName": "string", "parentDepartmentIdPaths": [ "string" ], "parentCorpDepartmentIdPaths": [ "string" ], "childDepartmentIds": [ "string" ], "childCorpDepartmentIds": [ "string" ] }}