开放院校开设专业

接口概述

• 接口名称：开放院校开设专业
• 接口用途：根据院校ID和省份，获取该院校在对应省份开设的专业列表，支持按专业排名或热门度排序。
• 请求路径：POST /api/v1/school/open-majors
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	必填	类型	说明	默认值
school_id	是	int	院校ID	-
province	是	string	省份名称	-
sort_field	否	string	排序字段。枚举值：ranking（按专业排名排序）、hot（按热门度排序）	ranking
sort_order	否	string	排序方向。枚举值：asc（升序）、desc（降序）	desc

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

返回结构

成功时返回标准成功响应，其中 data 为专业对象数组。

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "spname": "计算机科学与技术",
      "major_id": 123,
      "level_name": "本科",
      "type_name": "综合",
      "nature_name": "公办",
      "major_name": "计算机类",
      "spcode": "080901",
      "local_batch_name": "本科批",
      "kemu": "物理",
      "min": 620,
      "min_section": 5000,
      "plan_count": 30,
      "ranking": 5,
      "hot_num": 100
    }
  ]
}

字段说明

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

排序规则

• 默认排序字段：ranking
• 默认排序方向：desc

ranking 排序逻辑

1. 若两条记录的 ranking 均为 0，则按 min 降序排列；
2. 若其中一条 ranking 为 0，则该记录排在后面；
3. 其余情况按 ranking 升序排列（数值越小越靠前），当 sort_order 为 asc 时则反转。

hot 排序逻辑

1. 若 hot_num 相同，则按 min 降序排列；
2. 其余情况按 hot_num 降序排列，当 sort_order 为 asc 时则反转。

调用示例

请求

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

{
  "school_id": 123,
  "province": "河北",
  "sort_field": "ranking",
  "sort_order": "desc"
}

成功响应

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "spname": "临床医学",
      "major_id": 456,
      "level_name": "本科",
      "type_name": "医药",
      "nature_name": "公办",
      "major_name": "临床医学类",
      "spcode": "100201K",
      "local_batch_name": "本科批",
      "kemu": "物理+化学",
      "min": 640,
      "min_section": 3200,
      "plan_count": 25,
      "ranking": 3,
      "hot_num": 85
    }
  ]
}

错误响应（参数缺失）

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