api-spec/daisy/kalender.md

Specifikation för att hämta kalender

Hämta länk till personlig kalender-feed

Förfrågan

> GET /v1/calendar/subscription-credentials
> Authorization: Bearer <oauth 2 token>

Returnerar en länk till användarens personliga kalender-feed.

< 200 OK
< Content-Type: application/json

  {
    "icsUrl": "https://daisy.dsv.su.se/servlet/schema.PersonalCalendarICS?id=12345&token=abc123"
  }

Krav på icsUrl:

• Ska peka på den inloggade användarens personliga kalender-feed
• Ska fungera utan OAuth2 — URL:en bär sin egen autentisering (t.ex. via query-parametrar)
• Kan vara en relativ sökväg eller en fullständig URL
• Token ska vara permanent

Krav på ICS-feeden:

• Standard iCalendar-format (RFC 5545)
• Content-Type: text/calendar
• Innehålla VTIMEZONE-block för alla tidszoner som refereras av händelser
• Händelser som VEVENT-block med minst: UID, DTSTART, DTEND, SUMMARY