动态科目枚举查询

接口概述

项目	内容
接口名称	动态科目枚举查询
用途	根据省份+年份+数据来源，动态获取实际有数据的科目/科类枚举值
接口路径	POST /api/v1/meta/subjects
请求方法	POST

请求参数

参数名	类型	必填	说明
province	string	是	省份名称，如"江苏"、"北京"
year	string / number	否	年份，如"2025"、2024
source	string	是	数据来源标识，见下方来源映射表

source 来源映射表

source 值	适用场景
yifenyiduan	一分一段表、位次查询
yifenyiduan_2025	一分一段表（2025新表）
weici	位次分数查询
plans	历年招生人数、历年分数线、院校详情
plans_2024	2024招生计划
category_stats	录取分类统计
zhuanyefenshu	院校专业分数线测试表

响应参数

参数名	类型	说明
code	number	状态码，200 表示成功
message	string	提示信息
data	string[]	该省份+年份+数据来源下实际有数据的科目/科类列表，按字母升序排列

响应示例

{
  "code": 200,
  "message": "success",
  "data": [
    "物理类",
    "历史类"
  ]
}

调用示例

curl -X POST http://localhost:3666/api/v1/meta/subjects \
  -H "Content-Type: application/json" \
  -d '{
    "province": "江苏",
    "year": "2025",
    "source": "yifenyiduan"
  }'

注意事项

• 该接口查询的是数据库中实际存在数据的科目值，非写死配置。
• 不同年份、省份对应的科目体系可能不同（如老高考为文科/理科，新高考为物理类/历史类）。
• 返回结果已去重、过滤空值，并按字母升序排列。
• 当 year 为空时，不限制年份条件，返回该省份所有年份的去重科目。