api-spec/daisy/terminstider.md

Specifikation för att hämta terminer

Hämta lista över terminer

Förfrågan

> GET /v1/calendar/semesters
> Authorization: Bearer <oauth 2 token>

Returnerar en lista över akademiska terminer (VT/HT) med start- och slutdatum. Används av studentportalen för att låta användaren välja tidsintervall i schemavyn.

< 200 OK
< Content-Type: application/json

[
  {
    "code": "HT2025",
    "type": "HT",
    "year": 2025,
    "start": "2025-09-01",
    "end": "2026-01-18"
  },
  {
    "code": "VT2026",
    "type": "VT",
    "year": 2026,
    "start": "2026-01-19",
    "end": "2026-06-07"
  }
]

Krav på svaret:

• Ska innehålla VT och HT för föregående år, innevarande år och nästkommande år (sex terminer totalt)
• Terminerna ska vara sorterade kronologiskt i stigande ordning efter startdatum
• Svaret är inte användarspecifikt; samma lista gäller för alla inloggade användare

Krav på fälten (samtliga obligatoriska):

• code: unik identifierare för terminen, t.ex. "VT2026"
• type: "VT" eller "HT"
• year: kalenderåret terminen tillhör
• start: terminens första dag, ISO 8601-datum (YYYY-MM-DD)
• end: terminens sista dag (inklusive), ISO 8601-datum (YYYY-MM-DD)