查询下属机构

使用场景： 获取行政单位下属的行政单位或学校列表(需要业务侧根据使用场景做好缓存)

权限说明

请求方式：GET(HTTPS）

请求地址：https://oapi.epaas.qq.com/corp/relation/list?access_token=ACCESS_TOKEN&type=XXX

请求示例：

{
  "corpid": 1,
  "type": 2,
  "is_need_all": true
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "relation_list": [
    {
      "corpid": 2,
      "name": "深圳教育局",
      "type": 2,
      "logo": "xxx.xxx",
      "parent_corpid":1
    },
    {
      "corpid": 3,
      "name": "广州教育局",
      "type": 2,
      "logo": "xxx.xxx",
      "parent_corpid":1
    }
  ]
}

参数说明：

批量查询上级单位

权限说明

使用场景： 批量获取上级单位, 支持学校，教育局和虚拟机构

调用权限：

• 需要额外授权：应用申请白名单
• 支持用户票据
• 支持机构票据

请求方式：POST(HTTPS）

请求地址：https://oapi.epaas.qq.com/corp/office/superior?access_token=ACCESS_TOKEN

请求示例：

{
  "corpid_list":[1072324]
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "data_list": [
        {
            "corpid": 1072324,
            "superior_corpid": 1041801,
            "superior_name": "机构jimmy地区1",
            "is_deputy_office": 1
        }
    ]
}

参数说明：

绑定上下级关系

使用场景： 绑定机构上下级关系

权限说明

请求方式：POST(HTTPS）

请求地址：https://oapi.epaas.qq.com/corp/relation/bind?access_token=ACCESS_TOKEN

请求示例

{
  "corpid": 2,
  "sub_corpid_list": [
    1,
    3
  ]
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "data_list": [
    {
      "sub_corpid": 1,
      "errmsg": ""
    }
  ]
}

参数说明：

解绑上下级关系

使用场景： 解除机构间的绑定关系

权限说明

请求方式：POST(HTTPS）

请求地址：https://oapi.epaas.qq.com/corp/relation/unbind?access_token=ACCESS_TOKEN

请求示例

{
  "corpid": 2,
  "sub_corpid_list": [
    1,
    3
  ]
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "data_list": [
    {
      "sub_corpid": 1,
      "errmsg": ""
    }
  ]
}

参数说明：