48 lines
1.2 KiB
Markdown
48 lines
1.2 KiB
Markdown
# 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`) |