开发者文档

简体中文English

几分钟内完成电竞与体育数据集成。

所有 REST 接口统一部署在 https://api.citoapi.com/api/v1,返回标准 JSON 格式,并通过 x-api-key 请求头鉴权。

为什么开发者选择 Cito API

简洁的请求头鉴权

在请求头中传入 x-api-key: cito_... 即可,无需复杂的 OAuth 令牌刷新。

清晰的限流规范

Free 10 次/分钟(500/月),Starter 30 次/分钟(10k/月),Pro 100 次/分钟(250k/月),Scale 400 次/分钟(1M/月)。

中文战队与选手搜索

支持直接用“绿龙”、“小蜜蜂”、“全华班”、“黑龙”等常用中文称呼搜索真实赛事实体。

核心接口示例

GET/api/v1/lol/leagues

获取全部英雄联盟职业联赛列表(包含 LPL、LCK、LEC)。

GET/api/v1/cs2/rankings/vrs

拉取 CS2 最新 VRS 官方积分排名。

GET/api/v1/tennis/schedule

查询每日 ATP 与 WTA 网球赛程安排。

快速请求示例
curl "https://api.citoapi.com/api/v1/cs2/rankings/vrs" \
  -H "x-api-key: cito_your_api_key"

接口路径与 JSON 字段名保持英文稳定,确保生产代码长期兼容。

常见应用场景

  • 赛程查询与实时赛果同步
  • 选手生涯数据与历史转会记录
  • 实时赔率追踪与滚球概率读取
  • Webhook 事件推送与 WebSocket 订阅

透明的自助定价方案

免费版每月 500 次调用即可测试,无需联系销售或绑定信用卡,随时按需升级。

Free ($0 · 500/mo · 10 req/min) · Starter ($15/mo) · Pro ($59/mo +$15 WebSockets) · Scale ($100/mo)

常见问题

密钥应该放在前端还是后端?

请务必保存在服务端环境变量中,切勿在浏览器前端代码中暴露您的 cito_... 密钥。

如何查找特定战队或选手的 ID?

先调用对应项目的 /search 接口(支持中文别名),再用返回的 slug 或 ID 查询详情。