热门院校推荐

接口概述

项目	内容
接口名称	获取热门院校推荐列表
请求方法	POST
接口路径	/api/v1/schools/hot-school-list
是否需要登录	否

请求参数

参数名	类型	必填	说明
major_id	number	否	专业ID，用于筛选开设该专业的热门院校，默认 0
year	number	否	年份，默认去年，范围 2021-当前年份

返回结构

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "sid": 123,
      "logo": "https://static.gaokao.cn/upload/logo/xxx.jpg",
      "school_name": "某某大学",
      "min_score": 620,
      "min_rank": 5000,
      "hot_value": 1
    }
  ]
}

返回字段说明

字段	类型	说明
sid	number	学校ID
logo	string	学校logo地址，非http开头时自动拼接 https://static.gaokao.cn/upload/logo/
school_name	string	学校名称
min_score	number	最低录取分数
min_rank	number	最低录取位次
hot_value	number	热门值（越小越热门）

调用示例

curl -X POST http://localhost:3666/api/v1/schools/hot-school-list \
  -H "Content-Type: application/json" \
  -d '{
    "major_id": 0,
    "year": 2024
  }'