查专业分类
接口信息
| 项目 |
内容 |
| 接口名称 |
查专业分类 |
| 请求方法 |
POST |
| 接口路径 |
/api/v1/major-category |
| 是否需要认证 |
否 |
请求参数
| 参数名 |
类型 |
必填 |
默认值 |
说明 |
| level |
string |
否 |
本科 |
学历层次(如:本科、专科) |
| level2_name |
string |
否 |
- |
二级分类名称,用于筛选 |
| limit_year |
string |
否 |
- |
学制,用于筛选(如:四年、三年) |
响应格式
{
"code": 200,
"message": "success",
"data": {
"category_level_1": [
"哲学",
"经济学",
"法学",
"教育学",
"文学",
"历史学",
"理学",
"工学",
"农学",
"医学",
"管理学",
"艺术学"
],
"category_level_2": [
"哲学类",
"经济学类",
"财政学类",
"金融学类",
...
],
"tree_map": [
{
"name": "哲学",
"data": [
{
"name": "哲学类",
"num": 4,
"data": [
{
"major_id": 1,
"level2_name": "哲学",
"level3_name": "哲学类",
"name": "哲学",
"spcode": "010101",
"limit_year": "四年"
},
{
"major_id": 2,
"level2_name": "哲学",
"level3_name": "哲学类",
"name": "逻辑学",
"spcode": "010102",
"limit_year": "四年"
}
]
}
]
}
]
}
}
字段说明
data 顶层字段
| 字段 |
类型 |
说明 |
| category_level_1 |
string[] |
所有二级分类名称去重后的数组(即 level2_name 的去重值) |
| category_level_2 |
string[] |
所有三级分类名称去重后的数组(即 level3_name 的去重值) |
| tree_map |
array |
按二级分类 → 三级分类 → 专业列表 组织的三层树形结构 |
tree_map 数组元素
| 字段 |
类型 |
说明 |
| name |
string |
二级分类名称(如:哲学、经济学) |
| data |
array |
该二级分类下的三级分类列表 |
tree_map[].data 数组元素
| 字段 |
类型 |
说明 |
| name |
string |
三级分类名称(如:哲学类、经济学类) |
| num |
number |
该三级分类下的专业数量 |
| data |
array |
该三级分类下的具体专业列表 |
tree_map[].data[].data 数组元素(专业对象)
| 字段 |
类型 |
说明 |
| major_id |
number |
专业唯一标识 |
| level2_name |
string |
二级分类名称 |
| level3_name |
string |
三级分类名称 |
| name |
string |
专业名称 |
| spcode |
string |
专业代码 |
| limit_year |
string |
学制(如:四年、三年) |
专业搜索
接口信息
| 项目 |
内容 |
| 接口名称 |
专业搜索 |
| 请求方法 |
POST |
| 接口路径 |
/api/v1/major-search |
| 是否需要认证 |
否 |
请求参数
| 参数名 |
类型 |
必填 |
默认值 |
说明 |
| keyword |
string |
是 |
- |
搜索关键词,按专业名称模糊匹配 |
| level |
string |
否 |
本科 |
学历层次(如:本科、专科) |
响应格式
{
"code": 200,
"message": "success",
"data": [
{
"major_id": 1,
"level2_name": "哲学",
"level3_name": "哲学类",
"name": "哲学",
"spcode": "010101",
"id": 123
},
{
"major_id": 2,
"level2_name": "哲学",
"level3_name": "哲学类",
"name": "逻辑学",
"spcode": "010102",
"id": 124
}
]
}
字段说明
| 字段 |
类型 |
说明 |
| major_id |
number |
专业唯一标识 |
| level2_name |
string |
二级分类名称 |
| level3_name |
string |
三级分类名称 |
| name |
string |
专业名称 |
| spcode |
string |
专业代码 |
| id |
number |
对应原表的 job_id |