Back to API overview

Calendar

Team, Club or Group calendar

Definition

GET https://api-v2.swissunihockey.ch/api/calendars

Produces an up-to-date calendar in iCalendar (.ics) format (RFC 5545). This file can either be downloaded for import into an external calendar or it can be subscribed to using the Webcal URI-scheme (provisional).

To get a calendar for a team, use the team_id argument; for a club, use the club_id argument. To get a calendar for a group, use season, league, game_class and group arguments.

http://api-v2.swissunihockey.ch/api/calendars?team_id=TEAMID
webcal://api-v2.swissunihockey.ch/api/calendars?team_id=TEAMID

Here's the above link as webcal sample: webcal://localhost:5000/api/calendars?club_id=341.

If used with either team_id or club_id, events from the range of 1 month in the past and 12 months in the future will be returned. If used with season, league, game_class and group, events from the season indicated will be returned, regardless of request time.

Parameters may include:

club_id
string
Identifier of a club.
team_id
string
Identifier of a team.
season
integer
Season identifier, in the form of 2015 (4 digits).
league
string
League identifier, example: "1"
game_class
string
Game class identifier, example: "11"
group
string
Group identifier, example: "Gruppe 1"

Webserver answers in iCalendar format with the Mime-Type "text/calendar".