hmserver

应用管理

接口文档

新建 / 编辑应用

appId 为 6 位数字,留空自动从 100001 递增。三端包名与密钥写在下方平台配置。

平台配置(HARMONY / ANDROID / IOS)

密钥会回显便于核对;改完直接点保存。

应用列表

appId名称平台数状态操作

应用配置

一站式管理功能开关、心跳初始化、登录文案、支付与推荐应用。各模块可单独保存;公开配置客户端经 GET /api/v1/config/{appId}/public 拉取。

功能开关

用单选直接开关,无需手写 true/false。

VIP 入口
feature.vip_entry — 是否展示会员入口
社区互动
feature.community_social — 点赞/关注/评论/评分(不含发布作品)
公开图库 / 穿搭广场
feature.public_gallery — 衣匣穿搭广场浏览;墨间公共作品区。关则隐藏入口,发布接口仍可用
社区评分
community.rating_enabled
今日雅集
feature.yaji_enabled — 客户端是否展示墨间精选作品

初始化 / 心跳

启动后心跳间隔与公告文案。

登录相关

登录页提示与协议链接;账号体系仍走账号中心,此处仅远程文案。

支付配置

华为 IAP:回调地址、登录验单密钥、AGC 服务端密钥、商品映射。

1事件通知回调地址(粘贴到 AGC)

AGC → 收益 / 应用内支付 → 事件通知配置。沙盒建议用带 env=sandbox 的地址便于区分日志。

2华为登录 / IAP 验单密钥

服务端验单使用 OAuth client_credentials(与华为账号登录同一组 ClientId/Secret)。

3AGC 服务端密钥(鸿蒙 IAP JWT,必填)

AGC → 收益 → 服务端密钥管理。验单/核销走鸿蒙 API,必须填 KeyId + IssuerId + 私钥。

4商品 ID 映射

与「商品配置」同源。华为后台商品 ID 需与下表 huaweiProductId 一致。

类型code名称价格华为商品ID

5最近回调日志

时间环境事件商品状态说明

推荐应用

配置键 recommend.apps。图标由客户端按 id 本地映射。

暂无推荐应用,点击「添加应用」开始编辑。

高级 / 自定义键

未收入图形界面的键可在此追加;也可删除任意键。

KeyValue公开说明操作

菜谱列表

当前服务端菜谱目录,只读展示。封面与步骤图地址来自 AGC;客户端通过 /api/v1/cookbook/recipes 获取。

加载中…
ID菜名分类用时份量步骤封面

社区内容巡查

预览作品、下架 / 恢复 / 删除;「今日雅集」维护墨间精选。举报可处理并联动下架。当前应用由顶栏统一选择。

应用 100002

作品列表

ARTWORK 画栏(演示/真实用户);名画见「名画」页。

预览ID用户标题状态赞/评端侧审核时间操作

今日雅集

管理客户端首页精选作品(分类 yaji_today)。接口 /api/v1/admin/community/featured,客户端 GET /api/v1/community/yaji。分类最多 40 幅,用户自行提交每人最多 8 幅。移除只出精选,不删原作。

客户端总开关在「应用配置 → 功能开关 → 今日雅集」(feature.yaji_enabled)。旧配置键 today.gallery 已不再被客户端使用。

预览作品ID标题作者来源排序启用操作

名画列表

种子资源 FAMOUS_SEED · 卷轴名画 · 共 -

预览ID标题storageKey图源状态时间操作

举报列表

ID帖子举报人原因状态时间操作

推送服务

先在应用里配好 Push 凭证。演示应用会走模拟发送。正式推送需填 ProjectId + ClientSecret。

设备 Token

userIdtoken机型更新时间

字体库管理

维护分类与字体条目;客户端通过 GET /api/v1/fonts 拉取。下载地址优先用绝对 URL,否则为 {PUBLIC_BASE_URL}/fonts/{fileName}

新建 / 编辑字体

appId + code 幂等保存。分类可多选,逗号分隔,如 featured,kai

字体列表

- 条 · 生效下载地址见「解析 URL」

预览名称code分类标签解析 URL排序状态

分类维护

客户端顶部 Chip:精选 / 古书 / 楷书 / 行书 / 行草 / 英文。

code名称排序状态

新建 / 编辑商品

商品分两类:订阅型(自动续费)与 消耗型(一次性)。终身会员请用消耗型 + 周期 LIFETIME。

订阅型商品

对应华为 IAP 订阅商品,可配置自动续费。

code名称app周期天数价格商品ID续费

消耗型商品

支付成功后按天数延长会员,不写入自动续费订阅。

code名称app周期天数价格商品ID

后台开通 / 禁用

运营补发或禁用会员时使用。userId 必须是真实用户,可从下方会员行或「用户」页点击填入。

当前有效会员

含已作废记录,可还原;还原后仍沿用原来的套餐与到期时间。

userIdappId设备号设备型号planlevel来源来源详情statusactive到期续费操作

领取记录

活动领取全量记录(含已过期 / 已作废)。已作废可还原,也可由用户重新领取。

时间用户应用活动奖励套餐 到期设备号设备型号状态操作

当前有效订阅

appIdplanstatus续费周期结束最近订单

年会员限量活动

配置活动时间、名额和状态;已领取权益不会因结束活动而撤销。

尚未加载

数据报表

启动按设备去重,登录按用户去重。新增用户/新增设备写入独立统计表,打开本页每 15 秒刷新。充值不含后台发放与沙盒单。

尚未加载

近 14 日新增

新增用户 新增设备
日期新增用户新增设备活跃设备次日回访次留充值用户

埋点数据

启动按设备只留一条,登录按 userId 只留一条;重复上报会累加次数并更新最近时间。报表走独立统计表。

启动:- · 登录:-
最近时间首次次数分类appIduserId平台结果deviceId版本渠道IP说明

订单

预下单与已支付同一列表。续订挂在对应首购订单下,树形展示层级。

合计:-
订单号类型userIdappplan金额状态沙盒核销渠道平台时间

华为 IAP 回调

AGC 事件通知落库。收到后立即检查;失败由定时任务重试。

ID时间环境事件商品状态已处理重试说明操作

用户列表

ID昵称手机号设备号设备型号unionId状态创建时间

新增 / 编辑管理账号

权限模块:apps / configs / community / membership / push / users / admins。超级管理员拥有全部权限。

管理账号列表

ID用户名显示名角色权限状态操作