本省院校查院校

接口概述

• 接口名称：本省院校查院校
• 接口用途：根据多种筛选条件搜索院校列表，支持关键词、分数、位次、院校类型、特殊计划、办学性质等筛选。
• 请求路径：POST /api/v1/school/search
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	必填	类型	说明	默认值
keyword	否	string	关键词（按院校名称模糊匹配）	-
score_min	否	int	最低分数（按 min_score 过滤）	-
score_max	否	int	最高分数（按 min_score 过滤）	-
rank_min	否	int	最低位次（按 min_rank 过滤）	-
rank_max	否	int	最高位次（按 min_rank 过滤）	-
admission_min	否	int	最低录取率（预留字段，当前未参与过滤）	-
admission_max	否	int	最高录取率（预留字段，当前未参与过滤）	-
subjects	否	string[]	选科（预留字段，当前未参与过滤）	[]
special_plans	否	string[]	特殊计划。枚举值：强基计划、国家专项、地方专项	[]
school_types	否	string[]	院校类型。枚举值：985、211、双一流	[]
nature_types	否	string[]	办学性质。若首项为 中外合作/中外合办，会自动替换为 中外合作办学	[]
page	否	int	页码	1
limit	否	int	每页数量，最大 50	10
sort_field	否	string	排序字段。支持：hot、min_score、avg_score、min_rank、plan_count	hot
sort_order	否	string	排序方向。枚举值：asc（升序）、desc（降序）	asc
province	否	string	考生省份。cur 表示当前省份（默认替换为 江苏），空值默认 all	-
level_name	否	string	层次名称（如：普通本科、专科（高职））	-
type_name	否	string	类型名称（如：综合、理工）	-
area	否	string	地区（学校所在省份）	-

返回结构

成功时返回标准成功响应，其中 data 包含分页数据。

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "sid": 123,
        "name": "北京大学",
        "school_name": "北京大学",
        "type_name": "综合",
        "hot": 1,
        "min_score": 680,
        "min_rank": 100,
        "avg_score": 685,
        "plan_count": 50,
        "admission_count": null,
        "admission_rate": "0.02",
        "f985": true,
        "f211": true,
        "dual_class_name": "双一流",
        "nature_name": "公办",
        "level_name": "普通本科",
        "province": "北京",
        "city": "北京",
        "special_batch": "",
        "special_batch_basic": false,
        "special_batch_country": false,
        "special_batch_local": false,
        "mid_score_list": null,
        "mid_rank_list": null,
        "logo": "https://example.com/logo.png",
        "jobrate": "98.5%",
        "code": "10001"
      }
    ],
    "total": 100,
    "page": 1,
    "limit": 10
  }
}

字段说明

字段名	类型	说明
sid	int	院校ID
name	string	院校名称
school_name	string	院校名称（兼容字段）
type_name	string	院校类型（如综合、理工）
hot	int	热度值（数值越小越热门）
min_score	int	最低录取分数
min_rank	int	最低录取位次
avg_score	int	平均录取分数
plan_count	int	招生计划数
admission_count	int/null	录取人数
admission_rate	string	录取率（以字符串形式返回）
f985	boolean	是否为 985 院校
f211	boolean	是否为 211 院校
dual_class_name	string	双一流标识（如 "双一流" 或 ""）
nature_name	string	办学性质（如公办、民办）
level_name	string	层次名称（如普通本科、专科（高职））
province	string	学校所在省份
city	string	学校所在城市
special_batch	string	特殊批次标识
special_batch_basic	boolean	是否有强基计划
special_batch_country	boolean	是否有国家专项
special_batch_local	boolean	是否有地方专项
mid_score_list	null	中段分数列表
mid_rank_list	null	中段位次列表
logo	string	院校 Logo 地址
jobrate	string	就业率
code	string	院校代码

过滤逻辑

1. 关键词：按 name 进行模糊匹配。
2. 考生省份：按 stu_province 精确匹配；若未传则默认匹配 all。
3. 地区：按 province（学校所在省份）精确匹配。
4. 层次/类型：分别按 level_name、type_name 精确匹配。
5. 分数/位次范围：按 min_score、min_rank 进行数值区间过滤。
6. 院校类型：多个类型为 AND 关系。例如同时传入 985 和 211，则要求院校同时满足 f985=true 且 f211=true。
7. 特殊计划：多个计划为 AND 关系。例如同时传入 强基计划 和 国家专项，则要求院校同时满足对应标记为 true。
8. 办学性质：按 nature_name 精确匹配，仅取数组首项。

排序规则

• 若 sort_field 为 hot、min_score、avg_score、min_rank、plan_count，则按对应字段及 sort_order 排序。
• 若 sort_field 为空或不支持，默认按 hot 升序排列。

调用示例

请求

POST /api/v1/school/search HTTP/1.1
Content-Type: application/json

{
  "keyword": "北京",
  "province": "北京",
  "school_types": ["985"],
  "page": 1,
  "limit": 10,
  "sort_field": "hot",
  "sort_order": "asc"
}

成功响应

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "sid": 1,
        "name": "北京大学",
        "school_name": "北京大学",
        "type_name": "综合",
        "hot": 1,
        "min_score": 680,
        "min_rank": 100,
        "avg_score": 685,
        "plan_count": 50,
        "admission_count": null,
        "admission_rate": "0.02",
        "f985": true,
        "f211": true,
        "dual_class_name": "双一流",
        "nature_name": "公办",
        "level_name": "普通本科",
        "province": "北京",
        "city": "北京",
        "special_batch": "",
        "special_batch_basic": false,
        "special_batch_country": false,
        "special_batch_local": false,
        "mid_score_list": null,
        "mid_rank_list": null,
        "logo": "",
        "jobrate": "",
        "code": "10001"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 10
  }
}