院校专业简介

接口概述

• 接口名称：院校专业简介
• 接口用途：根据选科要求和筛选条件，获取院校专业简要信息列表及统计信息。
• 请求路径：POST /api/v1/school/major-brief
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	类型	必填	默认值	说明
subject_type	string	否	-	首选科目（物理/历史）
subjects	string[]	否	[]	再选科目（可选2门）
province	string	否	-	目标地区

subject_type 的可用值可通过动态接口获取：POST /api/v1/meta/subjects，source 传 "plans"。 再选科目范围可通过 POST /api/v1/score-v2/xuanke-rules 接口根据省份获取。 | school_type | string | 否 | - | 院校类型（全部类型/985院校/211院校/双一流/公办本科） | | keyword | string | 否 | - | 关键词搜索（院校名称或专业名称） | | page | number | 否 | 1 | 页码 | | limit | number | 否 | 10 | 每页数量 |

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 100,
    "page": 1,
    "limit": 10,
    "list": [
      {
        "sid": 123,
        "major_id": 456,
        "school_name": "北京大学",
        "major_name": "计算机科学与技术",
        "sg_infos": "物理+化学",
        "plan_count": 30
      }
    ],
    "statistics": {
      "school_count": 50,
      "major_count": 80,
      "major_coverage": 2.67
    }
  }
}

字段说明

data 对象

字段名	类型	说明
total	number	符合条件的总记录数
page	number	当前页码
limit	number	每页数量
list	array	院校专业列表
statistics	object	统计信息

list 项

字段名	类型	说明
sid	number	院校ID
major_id	number | null	专业ID
school_name	string	院校名称
major_name	string	专业名称
sg_infos	string | null	选科要求
plan_count	number	计划招生人数

statistics 对象

字段名	类型	说明
school_count	number	可报考院校数（当前页去重）
major_count	number	可报考专业数（当前页去重）
major_coverage	number	专业覆盖率（保留2位小数，上限100）

调用示例

请求

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

{
  "subject_type": "物理",
  "subjects": ["化学", "生物"],
  "province": "北京",
  "school_type": "985院校",
  "keyword": "计算机",
  "page": 1,
  "limit": 10
}

成功响应

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 50,
    "page": 1,
    "limit": 10,
    "list": [
      {
        "sid": 1,
        "major_id": 101,
        "school_name": "清华大学",
        "major_name": "计算机科学与技术",
        "sg_infos": "物理+化学",
        "plan_count": 30
      }
    ],
    "statistics": {
      "school_count": 20,
      "major_count": 50,
      "major_coverage": 4.17
    }
  }
}