# 获取组织架构

# 请求方法:

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 新文档上线,替换旧文档