# 获取组织架构

# 请求方法:

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 组织架构信息更新时间

# 注意事项

  1. 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
  2. access_token的获取参考获取应用有效凭证
  3. 主体组织架构需定时更新,推荐每日进行一次全量更新。
  4. 应用方可接受组织架构变更事件(增、删、改),参考文档组织架构变更事件推送

# 更新日志

日期 变更说明
2019-10-18 新文档上线,替换旧文档