批量获取学校信息

接口描述:

批量获取学校列表

接口地址:

  • https://api_server_url/school/list

请求方式:

  • GET

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
accessToken 接口访问凭证 query true string
lastSequence 上一次去数据后台返回给客户的Seq,默认为0 query false integer(int64)
limit 期望获取的数据量,0 < limit <= 1000,默认为1000 query false integer(int64)

响应状态

状态码 说明 schema
200 OK ApiRestResponse«List«SchoolVO»»
401 Unauthorized
403 Forbidden
404 Not Found

其他状态码参见:全局状态码

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": [
        {
            "id": "1158",
            "orgId": "207",
            "xxbsm": "1000018005",
            "xxbxlxm": "111",
            "xxdm": "1000018005",
            "xxmc": "杭钢集团公司幼儿园",
            "xxdz": "杭州市拱墅区半山街道南苑社区36号",
            "xxjc": "",
            "xxjj": "杭钢幼儿园创办于1958年,是一所省属企业园,园内环境优美,阳光充足,师资雄厚。占地面积2285平方米,建筑面积3875平方米,现有11个班级,327名幼儿,全园教职工47人,园长1人(副高级),专任教师33人(副高级1人,中级职称14人,100%具有大专以上学历及教师资格证)。作为一所企业幼儿园,杭钢幼儿园以“幸福教育,完美启点”为办园指导思想,努力培养幼儿成为让自己幸福,也能带给别人幸福的人。坚持依托周边资源开发课程,逐步形成幼儿园山野探究园本特色,围绕“山野、自然、生长”的教育理念,逐步形成“亲自然、真体验;乐探究、爱思考;敢挑战、品质优”的良好素养,为幼儿终身学习生活奠定基础。",
            "xxxzm": "1",
            "xxzt": "0",
            "lastSequence": 0
        }
    ]
}

错误时返回:

{
    "code": 500,
    "data": {},
    "message": "成功或异常消息",
    "status": "fail"
}

响应参数:

参数名称 参数说明 类型 schema
code 成功或异常编码 integer(int32) integer(int32)
data 成功或异常数据 array SchoolVO
message 成功或异常消息 string
status 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error string
Schema 属性:

SchoolVO

参数名称 参数说明 类型 schema
id 学校基本数据子类表ID integer(int64)
orgId 学校的组织机构id integer(int64)
xxbsm 学校标识码 string
xxbxlxm 办学类型码 string
xxdm 学校代码 string
xxdz 学校地址 string
xxjc 学校简称 string
xxjj 学校简介 string
xxmc 学校名称 string
xxxzm 学校性质 string
xxzt 学校状态 string
lastSequence 上一次去数据后台返回给客户的Seq,初次拉取时为0 integer(int64)

调用示例:

NodeJs - Axios:

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api_server_url/school/list?accessToken=AT-10-R6Bl-dFf8itd6BM-pdSMzKRTR-kTmlpO&lastSequence=0&limit=100',
  headers: {
    'X-App-Id': '1'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Java - OkHttp 示例:

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api_server_url/school/list?accessToken=AT-10-R6Bl-dFf8itd6BM-pdSMzKRTR-kTmlpO&lastSequence=0&limit=100")
  .method("GET", null)
  .addHeader("X-App-Id", "1")
  .build();
Response response = client.newCall(request).execute();
作者:杭州天音  创建时间:2022-06-24 18:50
最后编辑:杭州天音  更新时间:2025-08-22 15:44