35 lines
931 B
Markdown
35 lines
931 B
Markdown
# 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
|
|
```
|
|
|
|
```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 |