选科要求常见问题接口文档
接口列表
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": {}
}