有奖捉虫:云通信与企业服务文档专题,速来> HOT

接口描述

批量获取组织架构信息。

请求方法

POST(application/json)

请求地址

https://open.wecard.qq.com/cgi-bin/org/get-org-by-ids?access_token=access_token

输入参数

参数名称
参数描述
参数类型
是否必填
备注
access_token
应用有效凭证
String
通过获取应用有效凭证接口获取
org_ids
组织架构 ID 数组
List
例如:[1,2]

输出参数

参数名称
参数描述
参数类型
是否必填
备注
errcode
响应状态码
Integer
例如:0为成功,非0为错误
errmsg
响应状态信息
String
例如:success
organization
组织架构信息列表
List
-
organization.id
组织架构唯一 ID
Integer
-
organization.name
组织架构名称
String
-
organization.parent_id
父级组织架构唯一 ID
Integer
-
organization.updated_at
组织架构信息更新时间
Datetime
-
organization.full_name
父级到该级的全部名称
String
-

示例

{
"errcode":0,
"errmsg":"OK",
"organization":[
{
"id":9751,
"parent_id":0,
"name":"广东省深圳市南山区教育局",
"updated_at":"2020-04-29 14:05:08",
"full_name":"广东省深圳市南山区教育局"
},
{
"id":378627,
"parent_id":949,
"name":"子分组2",
"updated_at":"2019-07-23 22:27:34",
"full_name":"广东省深圳市南山区教育局/子分组2"
}
]
}