名称： knhb-hockey
描述： 查询荷兰曲棍球协会（KNHB）比赛中心（hockeyweerelt.nl）的荷兰曲棍球比赛日程与结果。适用于查找荷兰的曲棍球俱乐部、球队、即将举行的比赛或比赛结果。

KNHB 曲棍球比赛中心

查询荷兰曲棍球协会（KNHB）比赛中心 API，获取俱乐部、球队及比赛信息。

API 基础 URL

https://publicaties.hockeyweerelt.nl/mc

接口端点

列出所有俱乐部

curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[]'

响应包含字段：id、name、abbreviation、city、district.name、logo、hockey_types[]

按名称或城市搜索俱乐部

curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[] | select(.name | test("Westland"; "i"))'
curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq '.data[] | select(.city | test("Delft"; "i"))'

列出俱乐部的所有球队

curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs/{clubId}/teams" | jq '.data[]'

响应包含字段：id、name、short_name、type（Veld/Zaal）、category_group、category_name、next_match_date

获取球队的即将举行的比赛

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq '.data[]'

获取球队的官方（已进行）比赛

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/official" | jq '.data[]'

比赛响应包含：
- datetime — ISO 8601 格式（UTC）
- location.city、location.street、location.description
- home_team.name、home_team.club_name
- away_team.name、away_team.club_name
- home_score、away_score — 未进行的比赛为 null
- competition、poule、status、field

常用查询示例

查找俱乐部并列出其球队

# 查找俱乐部 ID
CLUB_ID=$(curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs" | jq -r '.data[] | select(.name | test("Westland"; "i")) | .id' | head -1)

# 列出球队
curl -s "https://publicaties.hockeyweerelt.nl/mc/clubs/${CLUB_ID}/teams" | jq -r '.data[] | "\(.id) \(.name) (\(.type)) - 下一场: \(.next_match_date)"'

获取指定球队的下一场比赛

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq '.data[0] | {
  date: .datetime,
  home: .home_team.name,
  away: .away_team.name,
  location: .location.city,
  field: .field
}'

格式化比赛日程（美观输出）

curl -s "https://publicaties.hockeyweerelt.nl/mc/teams/{teamId}/matches/upcoming" | jq -r '.data[] | "\(.datetime | split("T")[0]) \(.datetime | split("T")[1] | split(".")[0] | .[0:5]) - \(.home_team.name) vs \(.away_team.name) @ \(.location.city)"'

球队类别说明

• Senioren: 成年队（如 H1、D1 等）
• Junioren: U18 至 U21 青年队
• Jongste Jeugd: 青少年队（前缀为 MO/JO）
• MO = Meisjes Onder（女子青少年）
• JO = Jongens Onder（男子青少年）
• 示例：MO11 = 女子 U11 队

重要说明

• 时间均为 UTC — 阿姆斯特丹冬令时（CET）需加 1 小时，夏令时（CEST）需加 2 小时
• 使用 date 命令或合适的日期库进行转换，以获取正确的星期几
• type: "Veld" 表示室外曲棍球，type: "Zaal" 表示室内曲棍球
• 同一球队的 Veld 和 Zaal 赛季使用不同的 ID — 建议同时查询两者以获取完整赛程
• Veld 赛季：约 9 月至次年 6 月（室外）；Zaal 赛季：约 11 月至次年 3 月（室内）