院校详情

接口概述

• 接口名称：院校详情
• 接口用途：根据院校ID获取院校详细信息，包含基本信息、历年招生计划、选科要求、历年分数线、就业数据、AI分析、政策新闻、热门专业、同城/同类型院校推荐等。
• 请求路径：POST /api/v1/school/detail
• 请求方法：POST
• Content-Type：application/json

请求参数

参数名	类型	是否必填	默认值	说明
school_id	number	否	-	院校ID（优先）
id	number	否	-	院校ID（兼容字段）
subject_page	number	否	1	选科要求页码
subject_limit	number	否	10	选科要求每页数量

注意：school_id 和 id 至少传一个，优先使用 school_id。

返回结构

{
  "code": 200,
  "message": "success",
  "data": {
    "sid": 123,
    "name": "北京大学",
    "area": 1000,
    "num_subject": 100,
    "canteen": "良好",
    "jobrate": "98.5%",
    "gradute": "30%",
    "logo": "https://example.com/logo.png",
    "province": "北京",
    "city": "北京",
    "level_name": "普通本科",
    "type_name": "综合",
    "nature_name": "公办",
    "f985": "985",
    "f211": "211",
    "dual_class_name": "双一流",
    "imgs": ["https://example.com/img1.jpg"],
    "shuoshi": "有",
    "boshi": "有",
    "lishuyu": "教育部",
    "time": "1898",
    "xyjj": "学校简介...",
    "webs": "https://www.pku.edu.cn",
    "dormitory": "良好",
    "qjjh": 95,
    "zybw": 100,
    "sgjh": 500,
    "tel": "010-62751201",
    "address": "北京市海淀区",
    "code": 10001,
    "content": "学校描述内容...",
    "recruit_plans": [
      { "year": 2024, "total_num": 3000 }
    ],
    "subject_requirements": {
      "list": [],
      "total": 0,
      "page": 1,
      "limit": 10
    },
    "score_line": {
      "list": [],
      "total": 0,
      "page": 1,
      "limit": 10,
      "fl": []
    },
    "hyqx": [],
    "dqqx": [],
    "ai_analysis": {
      "snapshot": "",
      "strength": "",
      "campus_qa": ""
    },
    "policy_news": [
      { "id": 1, "title": "新闻标题", "publish_at": "2024-01-01", "link": "" }
    ],
    "top_majors": [
      { "spname": "计算机科学与技术", "major_id": 101 }
    ],
    "same_city_schools": [
      { "sid": 2, "name": "清华大学", "logo": "", "province": "北京", "city": "北京", "type_name": "综合" }
    ],
    "same_type_schools": [
      { "sid": 3, "name": "复旦大学", "logo": "", "province": "上海", "city": "上海", "type_name": "综合" }
    ]
  }
}

返回字段说明

字段名	类型	说明
sid	number	院校ID
name	string	院校名称
area	number	面积
num_subject	number	专业数量
canteen	string	食堂情况
jobrate	string	就业率
gradute	string	保研率
logo	string	Logo地址
province	string	所在省份
city	string	所在城市
level_name	string	层次名称
type_name	string	学校类型
nature_name	string	办学性质
f985	string	是否985
f211	string	是否211
dual_class_name	string	双一流名称
imgs	string[]	学校图片列表
shuoshi	string	硕士点
boshi	string	博士点
lishuyu	string	隶属关系
time	string	建校时间
xyjj	string	学校简介
webs	string	学校官网（取逗号分割后的第二个）
dormitory	string	宿舍情况
qjjh	number	就业前景
zybw	number	专业位数
sgjh	number	省计划
tel	string	电话
address	string	地址
code	number	院校代码
content	string	学校描述内容
recruit_plans	object[]	历年招生计划，每项含 year、total_num
subject_requirements	object	选科要求汇总，含 list、total、page、limit
score_line	object	历年分数线，含 list、total、page、limit、fl
hyqx	array	行业前景
dqqx	array	地区前景
ai_analysis	object	AI分析，含 snapshot、strength、campus_qa
policy_news	object[]	政策新闻，每项含 id、title、publish_at、link
top_majors	object[]	热门专业前5，每项含 spname、major_id
same_city_schools	object[]	同城院校前5，每项含 sid、name、logo、province、city、type_name
same_type_schools	object[]	同类型院校前5，字段同上

错误码

错误码	说明
23006	学校参数不能为空

调用示例

请求

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

{
  "school_id": 1,
  "subject_page": 1,
  "subject_limit": 10
}

成功响应

{
  "code": 200,
  "message": "success",
  "data": {
    "sid": 1,
    "name": "北京大学",
    "area": 1000,
    "num_subject": 100,
    "canteen": "良好",
    "jobrate": "98.5%",
    "gradute": "30%",
    "logo": "https://example.com/logo.png",
    "province": "北京",
    "city": "北京",
    "level_name": "普通本科",
    "type_name": "综合",
    "nature_name": "公办",
    "f985": "985",
    "f211": "211",
    "dual_class_name": "双一流",
    "imgs": ["https://example.com/img1.jpg"],
    "shuoshi": "有",
    "boshi": "有",
    "lishuyu": "教育部",
    "time": "1898",
    "xyjj": "北京大学创办于1898年...",
    "webs": "https://www.pku.edu.cn",
    "dormitory": "良好",
    "qjjh": 95,
    "zybw": 100,
    "sgjh": 500,
    "tel": "010-62751201",
    "address": "北京市海淀区颐和园路5号",
    "code": 10001,
    "content": "北京大学创办于1898年...",
    "recruit_plans": [
      { "year": 2024, "total_num": 3000 }
    ],
    "subject_requirements": {
      "list": [],
      "total": 0,
      "page": 1,
      "limit": 10
    },
    "score_line": {
      "list": [],
      "total": 0,
      "page": 1,
      "limit": 10,
      "fl": []
    },
    "hyqx": [],
    "dqqx": [],
    "ai_analysis": {
      "snapshot": "",
      "strength": "",
      "campus_qa": ""
    },
    "policy_news": [],
    "top_majors": [],
    "same_city_schools": [],
    "same_type_schools": []
  }
}

错误响应

{
  "code": 23006,
  "message": "学校参数不能为空",
  "data": {}
}