GAA API

API with results, fixtures and competitions info for GAA

原始信息汇总

数据集概述：GAA API

基本信息

• 名称：GAA API
• 类别：体育（Sports）
• 定价：提供免费（Basic）、$10/月（Pro）、$20/月（Ultra）三种订阅计划。
• 数据覆盖：当前专注于 Armagh GAA 的赛事数据，未来计划扩展。
• 数据更新：每天午夜（欧洲/都柏林时间）刷新一次。

数据内容

该 API 提供爱尔兰盖尔式运动协会（GAA）的赛程、结果和比赛信息，覆盖约 28 个比赛项目，包含约 470 个赛程/结果。具体包括：

• 郡际比赛（Inter-county）：
  • 全爱尔兰高级足球锦标赛（All-Ireland SFC）
  • 阿尔斯特锦标赛（Ulster championships）
  • 安联联赛（Allianz Leagues，包括足球和曲棍球）
  • Nickey Rackard Cup、McKenna Cup、未成年/U20 比赛等
• 成人俱乐部比赛（Adult Club Competitions）：
  • 高级联赛 1A/1B（Senior League 1A/1B）
  • 中级联赛 2A/2B（Intermediate 2A/2B）
  • 初级联赛（Junior League）
  • 预备队联赛（Reserve League）
  • 预备队锦标赛（Reserve Championship）

数据来源：非官方 API，数据来自 Armagh GAA 官方网站（armaghgaa.net）。

接口端点（Endpoints）

方法	端点	描述
GET	/health	API 健康检查
GET	/competitions	列出所有比赛项目及其赛程/结果计数
GET	/fixtures	即将进行的赛程
GET	/results	已结束的比赛结果
GET	/teams	球队信息及其赛程计数

查询参数

• /fixtures 和 /results：
  • competition（可选，字符串）：比赛项目 slug（如 gaa-football-all-ireland-senior-championship）或部分名称匹配
  • county（可选，字符串）：郡级筛选，默认 armagh
  • date_from（可选，字符串）：起始日期筛选（格式 YYYY-MM-DD）
  • date_to（可选，字符串）：结束日期筛选（格式 YYYY-MM-DD）
• /competitions 和 /teams：
  • county（可选，字符串）：郡级筛选，默认 armagh
  • competition（仅 /teams）：筛选特定比赛项目中的球队

响应格式

• 比赛（/fixtures, /results）：包含 id, homeTeam, awayTeam, homeScore, awayScore, venue, kickoffTime, competition, competitionSlug, round, date, activity, matchType, grade, county, referee 等字段。
  • homeScore / awayScore：格式为 goals-points，未进行的比赛为 null。
  • kickoffTime：ISO 8601 格式日期时间，已完成的比赛为 null。
  • activity：可选值包括 football, hurling, ladies_football, camogie。
  • matchType：inter_county 或 club。
  • grade：senior, intermediate, junior, minor, u20, u21, underage。
• 比赛项目（/competitions）：包含 id, slug, name, format, activity, matchType, grade, county, fixtureCount, upcomingCount, resultCount。
• 球队（/teams）：包含 id, slug, name, county, fixtureCount。

排序规则

• /results：按日期最新优先（再按开赛时间）
• /fixtures：按日期最近优先（再按开赛时间）
• /competitions：按名称字母序
• /teams：按名称字母序

错误码

• 200：成功
• 403：禁止访问（未通过 RapidAPI 代理）
• 500：服务端错误

限制与范围

• 包含：Armagh 郡级赛程页面上的所有郡际比赛及七个命名的成人俱乐部比赛。
• 不包含：县级以下的青少年/未成年俱乐部比赛，以及除 Armagh 外的其他郡（未来计划扩展）。

身份验证

需订阅 RapidAPI 计划，并在请求中包含 X-RapidAPI-Key 头信息，无需额外 API 密钥。