查询学校信息

使用场景： 查询学校详细信息

权限说明

请求方式：[GET, POST] (HTTPS）

请求地址：https://oapi.epaas.qq.com/school/get?access_token=ACCESS_TOKEN

请求包体：

{
    "corpid": 123,
    "need_qywx_corpid": true,
    "extend_fields": ["FieldA","FieldB"]
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "",
  "corpid": 123,
  "name": "腾讯",
  "full_name": "测试的学校全称aaa",
  "code": "机构编码",
  "address": {
      "country_id": 1,
      "province_id": 10,
      "province_name": "湖南省",
      "city_id": 10,
      "city_name": "长沙市",
      "area_id": 10,
      "area_name": "岳麓区",
      "detail_address": "",
      "province_code": 123, 
      "city_code": 123, 
      "area_code": 123
  },
  "use_type": 1,
  "school_type": 1,
  "manage_style": 1,
  "school_categories": "1,2,3",
  "qywx_corpid": "xxxxxxxxxx",
  "creator_info": {
      "name": "xx",
      "duty": "校长",
      "mobile": "18692234433",
      "email": "xxx@tencent.com"
  },
  "extend_profile": "{\"FieldA\": 01,\"FieldB\": 02}",
  "start_date": "2020-01-01",
  "end_date": "2020-01-01",
  "created_at":  "2020-01-01 01:01:01",
  "updated_at":  "2020-01-01 01:01:01",
  "logo":""
}

参数说明：

批量查询学校信息

使用场景： 批量查询学校详细信息

权限说明

请求方式：[POST] (HTTPS）

请求地址：https://oapi.epaas.qq.com/school/batch_get?access_token=ACCESS_TOKEN

请求包体：

{
    "corpids": [1,2],
    "need_app_status": true,
    "need_qywx_corpid": true,
}

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "data_list": [
        {
            "corpid": 1217416,
            "name": "jimmy测试sssss",
            "code": "sdfsfsf",
            "address": {
                "country_id": 312829,
                "province_id": 1,
                "province_name": "北京市",
                "city_id": 3118,
                "city_name": "北京市",
                "area_id": 102,
                "area_name": "西城区",
                "detail_address": "sdfsf",
                "province_code": 123, 
                "city_code": 123, 
                "area_code": 123
            },
            "use_type": 1,
            "school_type": 2,
            "start_date": "2022-02-17",
            "end_date": "2024-02-29",
            "manage_style": 100,
            "school_categories": "6",
            "qywx_corpid": "",
            "creator_info": {
                "name": "jimmy",
                "email": "",
                "duty": "sdfsfa",
                "mobile": "17311112222"
            },
            "created_at": "2022-02-17 15:55:39",
            "updated_at": "2022-02-17 15:55:39",
            "extend_profile": "",
            "corp_inner_secret": "",
            "corp_secret": "",
            "inner_sync_mode": 2,
            "external_sync_mode": 2,
            "inner_sync_type": 2,
            "external_sync_type": 2,
            "full_name": "",
            "logo":""
        }
    ]
}

参数说明：

查询学校列表

使用场景： 查询学校详细列表

权限说明

请求方式：[GET] (HTTPS）

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

请求示例： https://oapi.epaas.qq.com/corp/school/list_by_suite?access_token=USERTOKEN&is_name_fuzzy=true&name=test&need_qywx_corpid=true&need_superior=true&page_index=1&page_size=30&school_property=13,14,15,16,17,18,19,20,21,22

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "data_list": [
        {
            "corpid": 1501549,
            "name": "test",
            "address": {
                "location": "",
                "country_id": 0,
                "province_id": 22,
                "province_name": "湖南省",
                "city_id": 2201,
                "city_name": "长沙市",
                "area_id": 220100,
                "area_name": "岳麓区",
                "detail_address": ""
            },
            "qywx_corpid": "",
            "superior_corpid": 0,
            "superior_name": "",
            "school_property": "13",
             "code": "52008935",
             "user_scale": 1,
             "school_type": 2
        }
    ],
    "total": 1
}

参数说明：

扩展资料检索学校

使用场景： 扩展资料检索学校列表

权限说明

请求方式：[POST] (HTTPS）

请求地址：https://oapi.epaas.qq.com/school/profile/search?access_token=ACCESS_TOKEN

请求包体：

{
  "search_keys": [
    {
      "key": "search_key1",
      "value": "xxxxxx"
    }
  ],
  "page_index": 1,
  "page_size": 10
}

参数说明：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "corpid": "111",
      "name": "机构名"
    }
  ],
  "total": 1
}

参数说明：

创建学校

使用场景： 创建学校

权限说明

请求方式：POST (HTTPS）

请求地址：https://oapi.epaas.qq.com/school/create?access_token=ACCESS_TOKEN

{
  "name": "腾讯",
  "full_name": "腾讯学校全称",
  "code": "xxxx",
  "address": {
      "country_id": 312829,
      "province_id": 1,
      "city_id": 3118,
      "area_id": 311413,
      "detail_address": "湖南省长沙市岳麓区梅西湖路"
  },
  "use_type": 1,
  "school_type": 1,
  "creator_info": {
      "name": "腾讯",
      "email": "xxx@tencent.com", 
      "duty": "校长",
      "mobile": "18692234433"
  },
  "manage_style": 3,
  "school_categories": "1,2,3",
  "qywx_corpid": "xxxxxxxxxx",
  "extend_profile": "{\"FieldA\": 1,\"FieldB\": 2,\"FieldC\": 99}"
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "corpid": 1
}

参数说明：

更新学校信息

使用场景： 更新学校信息

权限说明

请求方式：POST (HTTPS）

请求地址：https://oapi.epaas.qq.com/school/update?access_token=ACCESS_TOKEN

{
  "corpid": 1,
  "name": "腾讯",
  "full_name": "腾讯学校全称",
  "code": "xxxx",
  "address": {
    "country_id": 312829,
    "province_id": 1,
    "city_id": 3118,
    "area_id": 311413,
    "detail_address": "湖南省长沙市岳麓区梅西湖路"
  },
  "school_type": 1,
  "creator_info": {
      "name": "腾讯",
      "email": "xxx@tencent.com", 
      "duty": "校长",
      "mobile": "18692234433"
  },
  "school_categories": "1,2,3",
  "extend_profile": "{\"FieldA\": 01,\"FieldB\": 02,\"FieldC\": 99}" 
}

参数说明：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0
}

参数说明：

删除学校（暂不支持）

使用场景： 删除学校

权限说明

请求方式：POST (HTTPS）

请求地址：https://oapi.epaas.qq.com/school/delete?access_token=ACCESS_TOKEN

请求包体：

{
    "corpid": 3
}

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": ""
}

参数说明：