# 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
```

```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`)