与车库的边界

上头短剧不另做一套后端。路径、字段和错误码以 docs/openapi/openapi.yamldocs/openapi/baas-app-v1.yaml 为准。这里只说明边界,不抄 schema。

接入方式与其它消费端相同:项目 API Key 标识上头短剧,用户 JWT 标识观众。见 BaaS 接入

直接复用

能力上头短剧怎么用
短剧列表、详情、分集剧场、详情、集数网格
播放凭证竖屏连播;凭证不过期规则与其它内容相同
金币、订单、会员金币解锁、周卡、订阅。周卡是 7 天会员套餐
设备会话、手机验证码游客看剧;登录后跨端同步
追剧、观看进度「我的」里的书架和续看
埋点、渠道、落地页Web → App 的下载和归因
首页楼层剧场的编辑精选
多项目上头短剧是独立项目码,schema 与心跳榜分开

这条产品自己的差异

这些能力挂在车库上,但语义是为上头短剧定的。消费端还没接上之前,它们主要存在于服务端和后台。

能力规则
解锁判定全站只有一处判定:免费集、已有解锁记录(不区分金币 / 广告 / 福利 / 订单)、有效会员,都算已解锁。章节列表和播放凭证走同一套结果
广告解锁只认广告平台的服务端回调。验签、按交易号幂等,再写入解锁记录。客户端播完事件不能解锁
运行参数每次广告解锁的集数、每日上限、插屏频控、福利数额、时长提醒,走运行参数 DRAMAHOOK_RUNTIME_CONFIG,不写死在业务代码里
区域cn / intl。判定顺序:请求头里的手动选择、IP、默认国内。只决定可见内容、广告平台和隐私同意类型
合规上架可上架区域必填;区域含国内时备案号必填;授权凭证必填。手动上架、批量上架和 Studio 导入 共用这道门禁
AI 标记Studio 导入自动标为 AI 生成。为真时播放器必须显示角标
支付通道下单后打开公司 H5 收银台(shark_pay 配齐密钥后挂载);回调验签履约。客户端回前台后查询订单状态

广告平台密钥和支付商户密钥放在部署配置里,不进仓库,不进接口响应。

还没有、或明确不建

说明
Apple / Google 登录计划内,服务端尚未完成。iOS 若提供第三方登录,必须同时提供 Apple 登录
消费端页面Web 与 App 都还不能完成刷剧、解锁、支付
AI 魔改、广告收益看板下一里程碑
开放上传、提现、自建广告系统不做

旧 H5 里已经有的金币解锁、充值、福利页面属于 v1,只作实现时的对照,不代表 v2 已经在 Web 上可用。