位次查询选科规则
接口概述
| 项目 |
内容 |
| 接口地址 |
/api/v1/score-v2/xuanke-rules |
| 请求方法 |
POST |
| Content-Type |
application/json |
请求参数
| 参数名 |
类型 |
是否必填 |
说明 |
| province |
string |
是 |
省份名称,如:北京、河北、山东等 |
请求示例
{
"province": "北京"
}
响应参数
成功响应
| 字段名 |
类型 |
说明 |
| code |
number |
状态码,成功为 200 |
| message |
string |
提示信息,成功为 "获取成功" |
| data |
object |
选科规则数据 |
| data.subjectsType |
number |
选科模式:2=3+1+2模式,3=3+3模式 |
| data.xuanke |
object / array |
选科选项,根据 subjectsType 返回不同结构 |
subjectsType = 2(3+1+2模式)
{
"subjectsType": 2,
"xuanke": {
"first": ["物理", "历史"],
"second": ["化学", "生物", "政治", "地理"]
}
}
subjectsType = 3(3+3模式)
{
"subjectsType": 3,
"xuanke": ["物理", "历史", "化学", "生物", "政治", "地理"]
}
错误响应
| 字段名 |
类型 |
说明 |
| code |
number |
错误码,固定为 30001 |
| message |
string |
错误提示信息 |
| data |
null |
固定为 null |
错误码说明
| 错误场景 |
message |
| province 为空或缺失 |
省份不能为空 |
| 省份在配置中不存在 |
省份规则不存在 |
| 选科模式不是 2 或 3 |
未知的选科模式 |
完整响应示例
成功示例(北京,3+3模式)
{
"code": 200,
"message": "获取成功",
"data": {
"subjectsType": 3,
"xuanke": ["物理", "历史", "化学", "生物", "政治", "地理"]
}
}
成功示例(河北,3+1+2模式)
{
"code": 200,
"message": "获取成功",
"data": {
"subjectsType": 2,
"xuanke": {
"first": ["物理", "历史"],
"second": ["化学", "生物", "政治", "地理"]
}
}
}
错误示例
{
"code": 30001,
"message": "省份不能为空",
"data": null
}
{
"code": 30001,
"message": "省份规则不存在",
"data": null
}