选科要求常见问题接口文档

接口列表

1. 获取常见问题和注意事项列表

• 接口地址：POST /api/v1/score-v2/common-question/list
• 请求方式：POST
• Content-Type：application/json

请求参数

参数名	类型	必填	默认值	说明
module_type	int	是	0	模块类型，取值范围：[1, 2, 3, 4, 5, 6]
sub_module_type	int	是	0	二级模块类型，取值范围：[1, 2, 3, 4]
page	int	否	0	页码（政策新闻列表 4,4 时分页必填，需同时传 limit）
limit	int	否	0	每页数量（政策新闻列表 4,4 时分页必填，需同时传 page）
sort_type	int	否	0	排序方式：1-发布时间倒序，2-排序倒序，3-浏览量倒序
keyword	string	否	''	关键词搜索（标题模糊匹配，仅政策新闻列表 4,4 有效）
category	int	否	0	分类筛选，取值范围：[1, 2, 3, 4]（仅政策新闻列表 4,4 有效）

响应示例 - 政策新闻分类筛选项 (4,3)

{
  "code": 200,
  "message": "success",
  "data": {
    "category_enum": {
      "1": "政策解读",
      "2": "考试信息",
      "3": "院校动态",
      "4": "重要公告"
    }
  }
}

响应示例 - 政策新闻列表分页 (4,4) 带分页

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "id": 1,
        "title": "标题",
        "school_name": "",
        "content": "内容",
        "answer": "回答",
        "sort": 100,
        "look_num": 500,
        "publish_at": "2024-05-27 10:00:00",
        "created_at": "2024-05-27 10:00:00",
        "category_enum": 1,
        "category_labels": {
          "enum_type": 1,
          "value_text": "政策解读"
        },
        "description": "内容摘要..."
      }
    ],
    "total": 100,
    "page": 1,
    "limit": 10
  }
}

响应示例 - 政策新闻列表 (4,4) 不带分页

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 1,
      "title": "标题",
      "school_name": "",
      "content": "内容",
      "answer": "回答",
      "sort": 100,
      "look_num": 500,
      "publish_at": "2024-05-27 10:00:00",
      "created_at": "2024-05-27 10:00",
      "category_enum": 1,
      "category_labels": {
        "enum_type": 1,
        "value_text": "政策解读"
      }
    }
  ]
}

响应示例 - 其他情况

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 1,
      "title": "标题",
      "school_name": "",
      "content": "内容",
      "answer": "回答",
      "sort": 100,
      "look_num": 500,
      "publish_at": "2024-05-27 10:00:00",
      "category_enum": 1,
      "description": "内容摘要..."
    }
  ]
}

错误响应示例

{
  "code": 400,
  "message": "模块类型参数错误",
  "data": {}
}

{
  "code": 400,
  "message": "二级模块类型参数错误",
  "data": {}
}

{
  "code": 400,
  "message": "分页参数不完整",
  "data": {}
}

{
  "code": 400,
  "message": "排序类型参数错误",
  "data": {}
}

{
  "code": 400,
  "message": "分类参数错误",
  "data": {}
}

---

2. 用户反馈提交

• 接口地址：POST /api/v1/score-v2/common-question/feedback
• 请求方式：POST
• Content-Type：application/json

请求参数

参数名	类型	必填	默认值	说明
feedback_type	int	是	-	反馈类型，取值范围：[1, 2, 3, 4]
content	string	是	-	反馈内容，最多 1000 字
contact	string	是	-	联系方式（邮箱或手机号），最多 100 个字符
page_title	string	否	''	页面标题

响应示例 - 成功

{
  "code": 200,
  "message": "提交成功",
  "data": {}
}

错误响应示例

{
  "code": 400,
  "message": "反馈类型不正确",
  "data": {}
}

{
  "code": 400,
  "message": "请详细描述您的问题或建议",
  "data": {}
}

{
  "code": 400,
  "message": "反馈内容最多1000字",
  "data": {}
}

{
  "code": 400,
  "message": "请输入您的邮箱或手机号",
  "data": {}
}

{
  "code": 400,
  "message": "联系方式最多100个字符",
  "data": {}
}

{
  "code": 400,
  "message": "系统错误，请稍后重试",
  "data": {}
}