更新日志
最近更新
新接口、新字段与行为变化。
五种语言的 SDK 新
- JavaScript / TypeScript、Python、Dart、Swift、Kotlin:REST 调用、实时订阅、断线自动重连和重连后的补齐、去重
- Flutter、iOS、Android 的动画直播原生组件
- 目前以源码提供,安装和示例见文档「SDK 与客户端库」
动画直播组件:App Key 一行代码嵌入 新
- pk_ 开头的公开 Key,只能加载组件、不能调数据接口,必须绑定域名白名单
- iframe 和脚本两种嵌法;可设每日观看上限和同时在线上限,可选签名模式
- 控制台自助新建、停用、轮换,并查看观看次数和被拒次数
实时推送修复与安全加固 新
- 实时推送:服务启动瞬间写入的消息不再被跳过;动画舞台显示实时比分
- 实时推送文档补充了断线重连、补齐和去重的规则,以及多条订阅规则时心跳的注意事项
- 控制台的写操作只接受来自门户自身页面的请求;门户、接口和后台都加了安全响应头
- 两步验证:同一账号 15 分钟内验证码累计输错 10 次,这段时间内不能再验证;组织要求全员开启时,没开启的成员会话立即退出
- 不建议把 Key 写在地址里(?key=):仍然可用,但 Key 会留在浏览器历史和代理日志里
接口返回字段调整(不兼容变更,接入方请核对) 新
- 改名:/api/v1/coaches、/api/v1/coaches/detail 的 tm_id 改为 coach_id;/api/v1/dict 里兼容接口码值的字段改名为 compat_code
- 换成本平台 id:14 个比赛类接口里的 match_source_id 改为 gmid;/api/v1/team/persons、/api/v1/team/persons/detail、/api/v1/teams/squads/history 的 team_source_id 改为 gtid
- 不再返回:教练、裁判、球队、场馆接口里各一个第三方站点 id 字段;/api/v1/logos 的存储地址和转存时间两个字段(图片地址在 url 里);赛程接口的 raw_ref;球员赛季统计的 raw;球员薪资的 source_player_id
- 接口目录 /catalog 只保留对接需要的属性,「不提供的接口」清单的键名改为 not_provided;/openapi.json 去掉内部扩展属性
- 各接口现在的字段以接口文档里的字段表为准
动画直播组件:2.5D 与 3D 两种画面
- 同一套布局(标准 / 宽屏 / 紧凑 / 手机竖屏)放 2.5D 平面动画或 3D 球场
- 12 个数据模块,含文字直播和阵容;3D 球衣颜色取自两队真实球衣
- 服务端换短期令牌,令牌绑定嵌入页面的域名;控制台自助配置并实时预览
- 新接口:POST /api/v1/widget/token,GET /api/v1/widget/options、/configs、/stats
接口文档按线上真实返回生成
- 每个接口的字段树、示例返回都来自一次真实请求
- 新增动画直播组件接入指南
实时推送接入文档
- WebSocket(票据换取、订阅指令)、SSE、MQTT 三种通道的接入说明与在线试连
集锦视频播放地址
- /api/v1/matches/video 返回本平台签发的 10 分钟有效播放地址
文字直播改为多源合并生成
- 文字直播按各源事件合并实时生成,REST、兼容接口和 MCP 返回一致
Logo 统一由本平台提供
- 所有接口里的球队、赛事、球员 logo 地址都是本平台地址
球队与球员过滤
- 球员、教练、球队赛季统计等接口支持按本平台球队 id(gtid)过滤
比分与事件更准
- 比分数组固定 7 个整数;多源合并时去掉重复进球、重复牌和无效进球