4. 基础能力 API 4.6 FAQ 问题列表【已开发，待数据联调】

Table of Contents

4.6 FAQ 问题列表【已开发，待数据联调】

GET /tieup/api/v1/faqs?business_category_code=user_subscription
X-App-Channel: main
X-App-Build: 120

查询参数：

参数 类型 必填 说明
business_category_code string 是 业务分类稳定编码，取自常见问题业务分类列表

请求 Header：

Header 必填 说明
X-App-Channel 是 当前渠道代码，服务端合并平台默认和渠道覆盖 FAQ
X-App-Build 是 当前 APP 非负整数构建号，用于最低可见构建号过滤

响应字段：

字段 类型 说明
faq_code string FAQ 稳定编码
category string 一级问题分类：user、artist、agency_company
business_category_code string 当前 FAQ 所属业务分类稳定编码
question string 问题标题
answer string 答案正文
content_format string 正文格式，当前为 markdown

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": [
    {
      "faq_code": "faq_user_recharge",
      "category": "user",
      "business_category_code": "user_subscription",
      "question": "如何充值糖果？",
      "answer": "请选择充值套餐后支付。",
      "content_format": "markdown"
    }
  ]
}

说明：

  • 鉴权：公开接口，不需要 Authorization。
  • business_category_code 缺失时返回 422；分类不存在或已禁用时返回空数组 []。
  • 只返回业务分类和 FAQ 均为启用状态的数据，结果按 FAQ 排序和 ID 升序排列。
  • FAQ 先按 min_app_build <= X-App-Build 筛选，再执行平台默认和渠道覆盖合并；渠道覆盖在当前构建号尚未生效时继续回退平台默认 FAQ。
  • min_app_build = 0 表示所有构建版本可见；X-App-Build 缺失或不在 0-4294967295 整数范围内时返回 422。
  • 当前接口已直接替换旧版按 category 可选筛选的契约，客户端必须先获取业务分类，再传 business_category_code 查询问题。