专业开设院校

接口概述

获取开设指定专业的院校列表，支持按招生省份、院校所在省份、院校类型及层次进行筛选分页查询。

请求路径

/api/v1/majors/:id/offering-schools

请求方法

GET

请求参数

参数名	类型	必填	说明
id	number/string	是	专业ID或slug（URL参数）
province	string	否	招生省份，默认不限
page	number	否	当前页码，默认 1
page_size	number	否	每页数量，默认 10
province_school	string	否	院校所在省份
type_name	string	否	院校类型（如综合、理工、医药等）
level_name	string	否	院校层次，可选值：本科、专科
is_985	number	否	是否985院校，传 1 表示只返回985
is_211	number	否	是否211院校，传 1 表示只返回211
is_dual_class	number	否	是否双一流院校，传 1 表示只返回双一流

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "items": [
      {
        "sid": 1,
        "hot": 1,
        "name": "北京大学",
        "province": "北京",
        "city": "北京市",
        "f985": "985",
        "f211": "211",
        "dual_class_name": "双一流",
        "type_name": "综合",
        "level_name": "普通本科",
        "logo": "https://...",
        "zybw": 0,
        "qjjh": 0,
        "sgjh": 0,
        "nature_name": "公办"
      }
    ],
    "data": [
      {
        "sid": 1,
        "hot": 1,
        "name": "北京大学",
        "province": "北京",
        "city": "北京市",
        "f985": "985",
        "f211": "211",
        "dual_class_name": "双一流",
        "type_name": "综合",
        "level_name": "普通本科",
        "logo": "https://...",
        "zybw": 0,
        "qjjh": 0,
        "sgjh": 0,
        "nature_name": "公办"
      }
    ],
    "total": 100,
    "page": 1,
    "pageSize": 10,
    "totalPages": 10,
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 100,
      "totalPages": 10
    }
  }
}

返回字段说明

data / items 字段

字段	类型	说明
sid	number	学校ID
hot	number	热度排序值
name	string	学校名称
province	string	所在省份
city	string	所在城市
f985	string | null	是否985，有值时为 "985"，否则为 null
f211	string | null	是否211，有值时为 "211"，否则为 null
dual_class_name	string | null	双一流类别，有值时为 "双一流"，否则为 null 或空字符串
type_name	string	学校类型
level_name	string	学校层次
logo	string	学校Logo地址
zybw	number	卓越计划标识
qjjh	number	强基计划标识
sgjh	number	双高计划标识
nature_name	string	办学性质

分页字段

字段	类型	说明
total	number	总记录数
page	number	当前页码
pageSize	number	每页数量
totalPages	number	总页数
pagination	object	分页信息对象

调用示例

curl -X GET "http://localhost:3666/api/v1/majors/123/offering-schools?page=1&page_size=10&province=北京"

注意事项

• 若专业不存在，返回 404 Not Found
• items 与 data 字段内容完全一致，均可使用
• 院校数据基于 gk_schools_prov_zhuanyefenshu_test 表 2022 年数据关联查询
• f985/f211 在数据库中实际存储为 985/211 字符串或 null；dual_class_name 实际存储为 双一流 或空/null
• is_985/is_211/is_dual_class 支持组合使用，例如 ?is_985=1&is_211=1 只返回既是985又是211的院校