MG-04-008 视频渠道更新接口
MG-CHANNEL-05,2026-10-16。渠道页“模型与成本更新”提供价格页、配置文档页、独立自动更新开关/间隔与结果;普通保存无二次确认。标准模型参数继续独立维护,目录发现不自动创建标准参数、验收或启用供给。
管理接口 /admin/v1/channels/{id}/updates:GET 返回 channel_id/version/policy/next_run_at/last_run_at/status/result。policy={enabled,update_costs,interval_minutes,pricing_url,documentation_url},间隔5至10080分钟,默认关闭/60分钟。来源链接为HTTPS、无凭据/查询/片段,只登记或打开,不作为任意抓取地址;适配器固定协议执行目录/报价查询。
PUT要求If-Match渠道版本,body={version:维护策略版本,policy};同时核对渠道及策略CAS,在途更新拒绝改设置。POST /updates/run要求If-Match渠道版本,手动操作同样取得PG租约。浏览器对应/backend路由传channel_version;Cookie/CSRF/同源/回环保护不变。后台API进程每30秒最多领取一个到期渠道,90秒超时/3分钟租约;默认不启动付费生成或执行Worker。启用新版策略后旧插件定时维护退出该渠道,保留绑定与历史执行。
成功目录/报价各保存原生发现快照;目录失败保留原配置,空/缺失型号只待核对,不删除/归档/停用。报价失败或空报价不复用旧快照更新成本。来源状态、最近/下次运行与更新/待核对项目持久化;错误消息固定,不存上游原始响应或密钥。
update_costs为true才自动应用明确成本:精确上游型号+请求协议、唯一报价,同CNY/USD币种和计费方式,fixed单价且按次/按秒单位明确;需要已有已核对成本/计费时点。积分/换汇、分组折扣、复杂分档/附加费/最低计费、缺失或歧义报价保留原值。人工成本与报价不同不覆盖;人工基线与报价一致时可交给自动维护,后续人工改价重新取得所有权。每次结果列出待核对理由。
复用现行cost_rule_versions及渠道原子保存,价格更新不改变原能力/启停/验收。租约、策略版本和渠道版本在同一成本事务加锁核对,Supply CAS保护人工并发;本轮所有明确成本整体提交,失败全部回滚。相同规范化价格不生成重复版本,历史Attempt报价不变。无第二套调度领域。
迁移039新增独立策略与运行状态表,不改历史数据;down保留表以防丢状态,up可重入。代码回退时先关闭策略并等待租约结束,保留所有已生效成本历史。共享预览仅迁移独立测试副本,不改其他业务库或生产服务。