# 获取组织架构
# 请求方法:
POST(application/json)
# 请求地址:
https://open.wecard.qq.com/cgi-bin/user/org-edu-list?access_token=access_token
# 参数说明:
{
"page": 1,
"page_size": 5000
}
参数 | 是否必填 | 类型 | 实例 | 说明 |
---|---|---|---|---|
access_token | 是 | String(128) | 应用有效凭证 | |
page | 是 | Integer | 1 | 分页下标 |
page_size | 是 | Integer | 5000 | 分页大小,每页最大数据是5000 |
# 响应说明:
正确时返回的json数据包如下:
{
"errcode": 0,
"errmsg": "success",
"page": 1,
"page_size": 5000,
"total": 9800,
"organization": [
{
"id": 9751,
"name": "广东省深圳市南山区教育局",
"parent_id": "0",
"updated_at": "2019-04-22 11:34:05"
}
]
}
参数 | 必填 | 类型 | 实例 | 说明 | |
---|---|---|---|---|---|
errcode | 是 | Integer | 0 | 响应状态码,0为成功 | |
errmsg | 是 | String | success | 响应状态信息 | |
page | 是 | Integer | 1 | 当前获取数据为第几页 | |
page_size | 是 | Integer | 5000 | 当前获取数据的页大小 | |
total | 是 | Integer | 9800 | 该主体下组织架构总数 | |
organization | id | 是 | Integer | 9751 | 组织架构唯一id |
name | 是 | String | 广东省深圳市南山区教育局 | 组织架构名称 | |
parent_id | 是 | Integer | 0 | 父级组织架构唯一id | |
updated_at | 是 | Datetime | 2019-04-22 11:34:05 | 组织架构信息更新时间 |
# 注意事项
- 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
- access_token的获取参考获取应用有效凭证。
- 主体组织架构需定时更新,推荐每日进行一次全量更新。
- 应用方可接受组织架构变更事件(增、删、改),参考文档组织架构变更事件推送。
# 更新日志
日期 | 变更说明 |
2019-10-18 | 新文档上线,替换旧文档 |