worldcup2026

一个免费的2026年世界杯API，提供实时比分、赛程、球队、场馆等数据。基于Node.js+Express+MongoDB开发，支持JWT认证和Swagger文档，开发者可以直接调用接口获取48支球队、12个小组、104场比赛的信息，也能自己部署运行。

Github地址

https://github.com/rezarahiminia/worldcup2026

功能特性

数据覆盖全：48支参赛队、16座场馆、完整赛程表，小组赛到决赛阶段都有。实时更新比赛分数和进球记录，自动刷新积分榜。双语支持，球队和场馆名称同时提供英文和波斯语。接口带Swagger交互文档，能在线测试。有JWT令牌验证、请求频率限制、响应压缩这些基础安全措施。

怎么用

直接调（免费用）

curl https://worldcup26.ir/get/games  # 全部赛程
curl https://worldcup26.ir/get/teams  # 全部球队‘
curl https://worldcup26.ir/get/groups  # 小组积分
curl https://worldcup26.ir/get/stadiums # 球场信息

自己搭

bash

git clone https://github.com/rezarahiminia/worldcup2026.git
cd worldcup2026npm install
cp .env.example .env.development  # 改数据库地址
npm run import:all         # 导入基础数据
npm run dev             # 跑起来

数据库用MongoDB，环境变量里配好连接串和JWT密钥就行。开发模式Swagger自动开，生产环境手动开ENABLE_SWAGGER=true。

数据导入有顺序：先小组→再球队→再球场→最后赛程，依赖关系不能乱。也可以直接跑npm run import:all一键搞定。