共 39 个接口文档
POST /api/v1/school/open-majors| 参数名 | 必填 | 类型 | 说明 | 默认值 |
|---|---|---|---|---|
| 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) |
rankingdescranking 均为 0,则按 min 降序排列;ranking 为 0,则该记录排在后面;ranking 升序排列(数值越小越靠前),当 sort_order 为 asc 时则反转。hot_num 相同,则按 min 降序排列;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": {}
}