实时与动画

实时推送 + 动画直播组件

数据层用 WebSocket / SSE / MQTT 推给你的服务;展示层用动画直播组件直接嵌进页面。两者用同一个 API Key、同一套授权。

三种实时通道

WebSocket

浏览器、App、服务端通用。先用 Key 换一次性 ticket(60 秒有效),再连接订阅。

POST https://api.sports.csap.ai/api/v1/realtime/ticket
wss://api.sports.csap.ai/ws?ticket=…

SSE

只读推送,浏览器自带断线重连,适合简单的页面展示。

GET https://api.sports.csap.ai/sse
X-API-Key: <你的 Key>

MQTT

适合大规模服务端订阅,主题与行业通用推送结构兼容。

主题 football/#
账号 = 你的 API Key

订阅方式、消息格式和在线试连见 实时推送文档。

动画直播组件

2.5D 平面动画 / 3D 球场
实时比赛 · 自动挑选正在进行的热门比赛(当前 6 场有动画数据)

一个可以嵌进网页或 App 的比赛动画直播:舞台放 2.5D 平面动画或 3D 球场,四周是比分条和数据页签。两种画面共用标准、宽屏、紧凑、手机竖屏 4 种布局,换画面只改配置。

  • 12 个数据模块:比分条、事件卡片、技术统计、事件时间线、场面聚合、势能、文字直播、阵容…
  • 4 套官方模板,可改配色、字体、圆角和品牌角标
  • 服务端换短期令牌,令牌绑定你的页面域名,页面里不放 API Key
  • 没有动画数据的比赛显示真实比分,并写明未开始 / 已结束

组件模板

官方经典全部套餐
夜间全部套餐
简约平面专业版
品牌定制旗舰版