模块说明
faq 提供常见问题的列表接口（无详情接口）：支持 class 分类筛选与分页，返回带 screen_list 筛选组（供渲染分类切换）与 pager 分页信息。
鉴权级别：可选。
接口一览
| 方法 |
URL |
鉴权 |
说明 |
| GET |
/api/faq |
可选 |
问题列表 / 筛选 / 分页 |
请求参数
| 参数 |
必填 |
说明 |
class |
否 |
分类筛选值（非法字符会返回 422） |
page |
否 |
页码，默认 1 |
GET /api/faq?class=pay&page=1
响应
{
"code": "OK",
"message": "",
"data": {
"title": "常见问题",
"class": "pay",
"screen_list": [ { "name": "全部", "value": "", "active": false }, { "name": "支付问题", "value": "pay", "active": true } ],
"faq_list": [ { "id": 1, "question": "...", "answer": "...", "...": "" } ],
"pager": { "page": 1, "page_size": 10, "record_count": 32, "page_count": 4 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 字段 |
说明 |
class |
回显当前筛选值 |
screen_list |
筛选组数据（含 active 标记），直接渲染分类 Tab |
faq_list |
问题列表（问答内容） |
注意事项
- 问答为"展开/收起"式交互时，答案已在列表数据中，无需逐条请求详情；
class 含非法字符时返回 422；- FAQ 无详情接口，页面内全部内容来自本列表。