4. 基础能力 API 4.2 APP 启动配置【基础探测通过，待数据联调】

Table of Contents

4.2 APP 启动配置【基础探测通过，待数据联调】

GET /tieup/api/v1/app/bootstrap
X-App-Channel: main
X-App-Platform: android
X-App-Market: tieup_hw
X-App-Version: 1.2.0
X-App-Build: 120

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "channel": {
      "channel_code": "main",
      "channel_name": "主渠道",
      "group_code": "banxin_social",
      "app_display_name": "Tieup",
      "logo_url": "https://example.com/logo.png"
    },
    "config_version": 1,
    "basic_config": {},
    "artist_config": {},
    "operation_contents": {
      "banner": [],
      "notice": [],
      "popup": [],
      "guide": []
    },
    "documents": {},
    "faqs": [
      {
        "faq_code": "faq_user_recharge",
        "category": "user",
        "business_category_code": "user_subscription",
        "question": "如何充值糖果？"
      }
    ],
    "payment_methods": []
  }
}

说明：

  • 聚合返回当前渠道可用的 tieup_business_config、运营内容摘要、协议版本、FAQ 摘要和支付展示策略等。
  • 运行时缓存 key 必须包含 tieup:business_config:version 版本号。
  • FAQ 摘要只返回启用业务分类和启用 FAQ，并按 X-App-Build 应用最低构建号过滤；摘要包含 business_category_code，不返回答案正文。
  • 当前实现缓存 key 为 tieup:api:bootstrap:{config_version}:{channel_code}:{platform}:{market_code}:{app_build}，缓存 300 秒；Redis 不可用时直接回源数据库。
  • 鉴权：公开接口，不需要 Authorization。
  • 测试状态：已完成代码实现和 PHP 语法检查，待真实渠道、运营内容、支付路由数据联调。

响应字段：

{
  "channel": {
    "channel_code": "main",
    "channel_name": "主渠道",
    "group_code": "banxin_social",
    "app_display_name": "Tieup",
    "logo_url": "https://example.com/logo.png"
  },
  "config_version": 1,
  "basic_config": {},
  "artist_config": {},
  "operation_contents": {
    "banner": [],
    "notice": [],
    "popup": [],
    "guide": []
  },
  "documents": {},
  "faqs": [
    {
      "faq_code": "faq_user_recharge",
      "category": "user",
      "business_category_code": "user_subscription",
      "question": "如何充值糖果？"
    }
  ],
  "payment_methods": []
}