位次查询选科规则

接口概述

项目	内容
接口地址	/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
}