BaaS 能力地图

读完本页应能按域找到要接的路径分组。权威路径与字段以 docs/openapi/baas-app-v1.yaml 为准，本页不抄 schema。

账号

能力	方法 · 路径
设备会话	`POST /api/v1/auth/device-session`
账密登录	`POST /api/v1/auth/account-login`
短信验证码 / 登录	`POST /api/v1/auth/phone-otp`、`phone-login`
找回密码	`POST /api/v1/auth/password-reset/request`、`confirm`
登出	`POST /api/v1/auth/logout`
当前用户	`GET` / `PATCH /api/v1/app/me`
改密、会话、登出设备	`/api/v1/app/me/password`、`sessions`、`logout-device`、`logout-all`、`deactivate`
并号	`POST /api/v1/app/identity/merge`
邀请	`/api/v1/app/invite/code`、`bind`、`records`、`share`
反馈	`POST /api/v1/app/feedback`
版本检查	`GET /api/v1/app/app-version/check`

能力	方法 · 路径
列表 / 详情	`GET /api/v1/app/content/{type}`、`/{id}`
章节	`GET /api/v1/app/content/{type}/{id}/chapters`
播放凭证	`POST /api/v1/app/play-ticket`
分类 / 标签	`GET /api/v1/app/categories`、`/api/v1/app/tags`

type：video | comic | novel | post | drama。列表服务端过滤未上架。短剧分集不走「独立视频」列表。

上头短剧还会用到 feed、追剧、运行配置、广告回调等路径；是否已收进契约以 YAML 与 contracttest 为准，见上头短剧 · 边界。

能力	方法 · 路径
VIP / 金币档位	`GET /api/v1/app/vip/plans`、`/api/v1/app/coin/plans`
钱包	`GET /api/v1/app/wallet`
下单 / 查单	`POST` / `GET /api/v1/app/orders`、`GET /api/v1/app/orders/{order_id}`
解锁	`POST /api/v1/app/content/{type}/{id}/purchase`
渠道回调	`POST /api/v1/pay/notify/{channel_code}`（渠道 → 车库，不是 App 调）

下单与解锁带 Idempotency-Key。通道含 Mock；shark_pay 配齐环境变量后挂载。见闭环 · 钱。

定价、上下架、套餐、渠道配置在 Admin 完成。BaaS 不提供「改内容元数据」「改套餐价格」这类运营写接口。