钥界
开放平台秋季接口变更讲解封面28:16

今日焦点 · 2026-11-19

开放性api 秋季变更说明:鉴权、配额与回调一次讲清

UP主 接口观察室 · 科技分区 · 更新于 2026-11-19 09:40

自 2026-11-12 起,用户标识只返回 union_id。片中按网关日志对照 40109 时钟偏移、HMAC-SHA256 五分钟窗口,以及 cursor 分页把 page_size 顶在 50 的实际影响。

播放 186.4万弹幕 1.2万点赞 9.6万

今日推荐

更多
幂等键接入账务回调封面16:04

幂等键 Idempotency-Key 接到打赏分成回调

边界实验室 · 播放 142.7万 · 弹幕 8630

同一笔通知重放三次,只允许入账一次。队列按指数退避,死信进人工抽屉。

立即播放
弹幕流分页取舍封面22:41

GraphQL 还是 REST:弹幕流怎么做游标

蓝桥接口组 · 播放 98.3万 · 弹幕 5402

offset 在高峰会漏段,cursor 以发送时间加消息号拼接,客户端不得自行解码。

立即播放
OpenAPI 组件编写封面11:28

OpenAPI 3.1 里写下 VideoStat 组件

文档工匠阿宁 · 播放 76.5万 · 弹幕 2190

播放、点赞、投币拆成 allOf,废弃字段标记 deprecated 而不是直接删。

立即播放
回调签名窗口封面19:55

Webhook 签名:HMAC-SHA256 与 300 秒窗口

网关值班周衡 · 播放 121.0万 · 弹幕 7344

时钟回拨时先对 NTP,再核对原始字节序,不要对 JSON 重新排版后验签。

立即播放
电视端设备码登录封面09:37

设备码流程在电视端的轮询间隔

客厅终端社 · 播放 64.2万 · 弹幕 1888

用户确认页只申请 video.read 与 stat.read,拒绝一次性要满全部 scope。

立即播放
令牌桶退让封面31:02

收到 429 之后,客户端怎样退让

流控笔记 · 播放 88.9万 · 弹幕 4210

尊重 Retry-After,再叠加 0 到 400 毫秒抖动,避免整点齐刷。

立即播放
账单字段对照封面14:18

创作者账单字段对照,2026 年秋季口径

数舱日报 · 播放 53.6万 · 弹幕 960

税前、渠道费、冻结中三段不要加总后再回写,冻结释放有单独事件。

立即播放
灰度切流封面24:06

网关 v3 先切 5% 流量的观察清单

青栈架构 · 播放 41.2万 · 弹幕 1330

对比 p95、验签失败率和回调堆积,连续两小时达标再放大到 20%。

立即播放

分区频道

全部分区

科技 · 网关与鉴权

更多
双向证书过渡封面17:33

mTLS 与应用密钥并存的过渡周

证书课代表 · 播放 33.8万 · 弹幕 740

旧密钥保留 14 天只读,写接口强制证书。轮换日写在响应头。

立即播放
追踪号传递封面13:20

trace_id 从网关传到转码回调

链路铺 · 播放 29.4万 · 弹幕 610

回调体不放追踪号,放在 X-Trace 头,避免进业务哈希。

立即播放
多活幂等表封面26:48

多活机房里幂等表选本地还是中心

边界实验室 · 播放 38.1万 · 弹幕 990

金额类走中心表,播放量计数允许分区合并,冲突以较大值封口。

立即播放
沙箱配额说明封面08:12

沙箱每日 2 万次之后怎样申请提额

开放值班 · 播放 18.6万 · 弹幕 402

提额单要附错误分布,纯 200 刷量不会通过。

立即播放

游戏 · 对局与库存

更多
回放下载接口封面15:12

对战回放文件的开放下载与签名 URL

关卡数据局 · 播放 72.4万 · 弹幕 3102

链接 15 分钟失效,范围限制在参赛者 union_id。

立即播放
赛季积分回调封面08:55

赛季积分 Webhook 丢包后的重放顺序

排位观察 · 播放 27.6万 · 弹幕 880

按 season_seq 排序,不允许用到达时间覆盖名次。

立即播放
库存乐观锁封面21:07

物品库存接口上的乐观锁版本号

背包接口 · 播放 19.8万 · 弹幕 640

冲突返回 409 与最新 version,客户端只重试一次。

立即播放
直播挂件房间号封面12:44

直播挂件读取房间号需要的最小 scope

挂件工坊 · 播放 22.1万 · 弹幕 510

room.basic 足够,不要顺手申请私信权限。

立即播放

生活 · 日程与城市数据

更多
告警接入表格封面10:16

家用告警事件写进投稿排期表

生活自动化 · 播放 18.4万 · 弹幕 266

只订阅离线与存储满两类,避免每分钟心跳撑爆配额。

立即播放
快递字段清洗封面18:29

轨迹查询里城市名与网点编码不一致

包裹雷达 · 播放 25.7万 · 弹幕 733

以网点编码为准,城市字段只做展示,入库前做别名表。

立即播放
忙闲与投稿封面07:48

日历忙闲接口接上更文日

创作日程局 · 播放 14.2万 · 弹幕 198

时区固定 Asia/Shanghai,跨日直播按开始时间归日。

立即播放
读数时区封面16:55

表计读数接口的时区与采样缺口

城市探针 · 播放 11.9万 · 弹幕 154

缺口超过 20 分钟标 partial,不要用线性插值冒充实测。

立即播放

动画 · 协议图解

更多
授权码四步动画封面20:33

动画讲清授权码的四步跳转

帧解说 · 播放 91.5万 · 弹幕 6400

state 必须原样带回,图里用颜色标出被丢掉的那一次。

立即播放
签名串拼接动画封面06:40

三分钟看签名串的拼接顺序

帧解说 · 播放 67.3万 · 弹幕 4550

方法、路径、时间戳、正文哈希,中间只用换行,不加空格。

立即播放
弹幕长连接动画封面27:18

弹幕从轮询改成长连的动画稿

动画科普通 · 播放 44.0万 · 弹幕 2011

心跳 30 秒,断线用上次 ack 续传,不从零重拉。

立即播放
配额耗尽短剧封面13:05

配额耗尽时的错误页该怎么说人话

接口剧场 · 播放 15.6万 · 弹幕 870

把重置时刻写成分钟,而不是只丢一个 429。

立即播放

音乐 · 声波与曲目数据

更多
曲目元数据封面12:26

曲目开放字段:ISRC、时长和分区标签

频谱文档 · 播放 21.4万 · 弹幕 390

时长用毫秒整数,展示层再格式化,避免浮点对不齐。

立即播放
波形抽样封面09:18

波形预览只给 120 个抽样点

声波小组 · 播放 16.8万 · 弹幕 275

接口不返回原始采样,峰值归一到 0–255 的整数。

立即播放
歌单协作封面18:02

协作歌单的版本向量怎么合并

夜航曲库 · 播放 13.1万 · 弹幕 188

同位置冲突保留两边并打标,不静默覆盖。

立即播放
演出票务回调封面11:47

演出开售提醒与库存回调对齐

场馆接口 · 播放 19.5万 · 弹幕 460

开售时间用 Unix 毫秒,页面按观众时区换算。

立即播放

热门排行

统计截至 2026-11-19 18:00
1回调重试与幂等:开放平台最容易翻车的一晚边界实验室326.8万
2OAuth 设备码在电视端的落地笔记客厅终端社291.2万
3播放量回写数仓的字段对照数舱日报254.7万
4签名串拼接顺序图解帧解说221.4万
5429 与 Retry-After 的客户端退让流控笔记198.6万
6union_id 替换明文用户号接口观察室186.4万
7弹幕长连的 ack 续传动画科普通163.0万
8对战回放的短时签名 URL关卡数据局142.7万
9HMAC 时间窗设成 300 秒的理由网关值班周衡121.0万
10VideoStat 在 OpenAPI 3.1 里的拆法文档工匠阿宁109.5万

正在直播

全部直播间

接口资讯与创作者动态

本周

常见问题

申请应用时要准备哪些材料?

准备应用名称、回调地址、联系邮箱,以及计划使用的 scope 列表。视频元数据读权限与账单读权限要分开申请。回调地址必须是 https,沙箱与生产各登记一条。

签名一直失败,先看哪里?

先核对服务器时间是否落在 300 秒窗口内,再确认参与签名的是原始请求字节。重新格式化 JSON、增减空格或改变字段顺序,都会得到另一条摘要。40109 与密钥错误不是同一条码。

测试环境的配额和正式环境一样吗?

不一样。截至 2026-11-19,沙箱为每应用每日 2 万次,正式环境按审核档位计算。两边的 union_id 不互通,沙箱里的播放量不会进正式报表。

视频时长、弹幕数这些字段会改名吗?

本季稳定字段写在 VideoStat。废弃项会先标 deprecated,至少一个小版本后才移除。请忽略未知字段,不要因为多一个键就拒绝整段响应。

调用被临时降速后如何申诉?

在应用后台提交申诉,附上 trace_id、时间范围和错误码分布。只写“请求突然失败”无法定位。处理结果会回到登记邮箱,一般在两个工作日内。