4. 基础能力 API 4.2.1 APP 基本配置信息【已开发，待数据联调】

Table of Contents

4.2.1 APP 基本配置信息【已开发，待数据联调】

公开读取当前 APP 渠道可展示的官方网站、官网微信、星探联盟佣金比例和客服联系方式。

完整请求示例：

GET /tieup/api/v1/app/basic-config
X-App-Channel: main

鉴权：公开接口，不需要 Authorization。X-App-Channel 必填，缺失或渠道不存在时返回 422；接口不接收查询参数或请求体。

完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "official_website_url": "https://www.example.com",
    "official_wechat_public_account": "Tieup官网微信",
    "scout_alliance_commission_rate": 20,
    "customer_service_phone": "400-000-0000",
    "customer_service_wechat": "tieup_service",
    "customer_service_email": "service@example.com"
  }
}

响应字段：

字段 类型 说明
official_website_url string 官方网站地址，读取后台基础配置；未配置时返回空字符串
official_wechat_public_account string 官网微信，读取后台基础配置；未配置时返回空字符串
scout_alliance_commission_rate integer 星探联盟佣金比例，范围 0-100；未配置时返回 0
customer_service_phone string 客服电话，读取后台基础配置；未配置时返回空字符串
customer_service_wechat string 客服微信，读取后台基础配置；未配置时返回空字符串
customer_service_email string 客服邮箱，读取后台基础配置；未配置时返回空字符串

说明：

  • 服务端先读取平台默认基础配置，再使用 X-App-Channel 对应的启用渠道配置覆盖同名字段。
  • 响应仅允许返回上述 6 个公开字段，不返回平台费率、提现、充值、RTC 渠道或其他内部基础配置。
  • 缓存 key 为 tieup:api:basic-config:v2:{config_version}:{sha1(channel_code)}，缓存 300 秒；后台保存配置会刷新配置版本，Redis 异常时直接回源数据库。