院校详情开设专业

接口概述

• 接口名称：院校详情开设专业
• 接口用途：根据院校ID和省份，获取该院校在对应省份开设的专业列表。
• 请求路径：POST /api/v1/schools/open-majors
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	必填	类型	说明	默认值
school_id	是	int	院校ID	-
province	是	string	省份名称	-
page	否	int	当前页码	1
limit	否	int	每页显示数量	10

注意：school_id 与 province 必须同时传入，否则返回错误码 23008。

返回结构

成功时返回标准成功响应，其中 data 为分页对象。

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "spname": "计算机科学与技术",
        "spcode": "080901",
        "local_batch_name": "本科批",
        "kemu": "物理",
        "min": 620,
        "min_section": 5000,
        "major_id": 123,
        "province": "河北",
        "hot_num": 100,
        "sg_name": "",
        "ranking": 5,
        "level_name": "本科",
        "type_name": "综合",
        "nature_name": "公办",
        "major_name": "计算机科学与技术",
        "plan_count": 1
      }
    ],
    "total": 50,
    "page": 1,
    "limit": 10,
    "pages": 5
  }
}

字段说明

字段名	类型	说明
spname	string	专业名称
spcode	string	专业代码
local_batch_name	string	本地批次名称
kemu	string	科目要求
min	int	历年最低录取分数
min_section	int	历年最低录取位次
major_id	int	专业ID
province	string	省份
hot_num	int	热门度（无数据时为 0）
sg_name	string	专业组信息
ranking	int	专业排名（无数据时为 0）
level_name	string	院校层次（如本科、专科）
type_name	string	院校类型（如综合、理工）
nature_name	string	办学性质（如公办、民办）
major_name	string	所属专业类名称（与 spname 一致）
plan_count	int	招生计划条数（固定为 1）

调用示例

请求

POST /api/v1/schools/open-majors HTTP/1.1
Content-Type: application/json

{
  "school_id": 123,
  "province": "河北",
  "page": 1,
  "limit": 10
}

成功响应

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "spname": "临床医学",
        "spcode": "100201K",
        "local_batch_name": "本科批",
        "kemu": "物理+化学",
        "min": 640,
        "min_section": 3200,
        "major_id": 456,
        "province": "河北",
        "hot_num": 85,
        "sg_name": "",
        "ranking": 3,
        "level_name": "本科",
        "type_name": "医药",
        "nature_name": "公办",
        "major_name": "临床医学",
        "plan_count": 1
      }
    ],
    "total": 30,
    "page": 1,
    "limit": 10,
    "pages": 3
  }
}

错误响应（参数缺失）

{
  "code": 23008,
  "message": "开放专业参数不能为空",
  "data": {}
}