跳转到主要内容

传递 API Key 的方式

新版接口(https://data.anysport.io/v1/soccer)只支持一种方式:放在 HTTP 请求头里,请求头名固定为 apikey(全小写,没有 X- 前缀),值就是你的 API Key 本身。
与旧版的区别(重大变更):旧版 api.anysport.io 支持 X-API-Key 请求头或 ?api_key= 查询参数两种方式二选一;新版 不再接受任何形式的查询参数传 key(?api_key=/?apikey= 均无效),也不再使用 X-API-Key 这个头名。只认请求头 apikey,请求头缺失、名字写错(如仍用 X-API-Key)或把 key 拼在 URL 查询参数里,都会被判定为未认证,返回 401 UNAUTHORIZED。迁移时请检查代码里是否还在用查询参数传 key。

代码示例

获取 API Key

  1. 前往 dashboard.anysport.io 注册账号。
  2. 验证邮箱中收到的 6 位数字验证码。
  3. 登录后,API Key 直接显示在控制台首页,随时可复制。
每个订阅套餐对应一个独立的 API Key。如果你持有多个订阅,每个 Key 对应不同的套餐权限和用量配额。

重新生成 API Key

你可以随时在控制台重新生成 API Key。旧 Key 立即失效。新 Key 始终在控制台可见,可随时复制。

安全最佳实践

  • 切勿将 API Key 提交到代码仓库(如 Git)。
  • 将 Key 存储在环境变量(.env 文件)中,而非硬编码在代码里。
  • 如果怀疑 Key 已泄露,请立即重新生成。
  • 不要在公开可访问的客户端 JavaScript 代码中暴露 Key。
  • 不要把 Key 拼接在 URL 查询参数里(新版本本就不支持这种方式)——URL 更容易被写入服务器访问日志、浏览器历史、代理缓存等中间环节。

错误响应