院校详情
接口概述
- 接口名称:院校详情
- 接口用途:根据院校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,字段同上 |
错误码
调用示例
请求
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": {}
}