Files
shaguabijia-app-server/docs/api/platform/platform-huawei-review.md
T
zuochenyong c53ce896f7 feat(huawei-review): 华为审核开关(admin 可切 + 客户端下发 + 审计) (#147)
华为应用市场审核要求新手引导的「快速设置」权限步必须可被用户关闭,平时又要
保住权限开启率,故做成后台可切的两态开关,送审期间切开、过审后收回。

- app_config 新增 huawei_review 行(default / review),空库与脏值一律回退
  default = 上线至今的现状,宁可不给退出按钮也不误放开
- admin: GET/PATCH /admin/api/huawei-review,权限 operator/tech,切换写审计
- 客户端: GET /api/v1/platform/huawei-review 不鉴权(引导页在登录前就展示),
  下发 onboarding_closable;机型 gate 由客户端做,故此处不判 ROM

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: 左辰勇 <exinglang@gmail.com>
Reviewed-on: #147
Co-authored-by: zuochenyong <zuochenyong@wonderable.ai>
Co-committed-by: zuochenyong <zuochenyong@wonderable.ai>
2026-07-21 10:43:58 +08:00

1.7 KiB
Raw Blame History

GET /api/v1/platform/huawei-review — 华为审核开关

所属:Platform 组(前缀 /api/v1/platform | 鉴权:无 | ← 返回 API 索引

华为应用市场审核要求:新手引导的**「快速设置」权限步必须可被用户关闭**(引导视频页不在要求内)。本端点把运营后台配的开关下发给客户端,决定该步左上角是否出现退出按钮。

不鉴权:引导页在登录之前就展示,此时客户端必然没有 token。

值来自 app_config 表的 huawei_review 行(admin 页 GET / PATCH /admin/api/huawei-review 可改),空库回退 default

入参

无。

出参

响应 200:HuaweiReviewOut

字段 类型 说明
mode string default(强制展示,不可关闭 = 上线至今的现状)/ review(可关闭,过审用)。仅供排查时看后台切成了哪态
onboarding_closable bool 快速设置权限步是否允许用户退出(= mode == "review")。客户端只读这一个字段决策

Mock 出参:

{
  "mode": "review",
  "onboarding_closable": true
}

说明

  • 只有华为 ROM 客户端会来拉HarmonyOS / EMUI;荣耀 MagicOS 不拉)。机型判断在客户端做(OemDetector),服务端不看 UA,也就不用维护机型名单。
  • 客户端在进新手引导前拉一次并本地缓存;请求失败/超时用上次缓存值,从未拉到过则按 onboarding_closable=false(宁可不给退出按钮,也不误放开)。
  • 脏值兜底:DB 里 mode 不在枚举内时服务端一律回退 default
  • 切回 default 即可一键收回退出按钮(审核通过后无需发版)。