Luftsportkalenderen

Arrangementene i Luftsportkalenderen: kurs, konkurranser, møter og mye mer. Hent dem for en klubb, en kommune eller hele landet, som JSON til egne nettsider, som kalenderabonnement eller som RSS.

API-et ligger på kalender.nlf.no. Alle strømmene gir kommende arrangementer, de første først. Tidspunktene er i ISO 8601-format.

Arrangementene til en klubb

GET kalender.nlf.no/api/klubb/{ids}/{format}

For klubber som vil vise sine egne arrangementer på egen nettside. Kan brukes direkte fra nettsider på andre domener (CORS er åpent), og oppdateres hvert kvarter.

Parameter	Beskrivelse
`ids`	Klubbens organisasjons-ID-er, skilt med komma. En klubb kan ha flere, for eksempel én for hovedlaget og én for hver gruppe. Høyst 20.
`format`	`json`, `ical` (kalenderabonnement) eller `rss`.
`from`	Valgfri. Ta med arrangementer som slutter fra og med denne datoen, for eksempel `2026-01-01`. Uten den: fra i dag.
`limit`	Valgfri. Høyst så mange arrangementer, opptil 1000.

For eksempel: https://kalender.nlf.no/api/klubb/12345,67890/json?limit=10

Arrangementene i en kommune

GET kalender.nlf.no/api/kommune/{nummer}/{format}

Arrangementene som holdes i kommunen. Kan brukes direkte fra nettsider på andre domener (CORS er åpent).

Parameter	Beskrivelse
`nummer`	Kommunenummeret, fire sifre, for eksempel `0301` for Oslo.
`format`	`json`, `ical` eller `rss`.

For eksempel: kalender.nlf.no/api/kommune/0301/json

Feltene for hvert arrangement (JSON)

Felt	Beskrivelse
`id`	Arrangementets ID i kalenderen.
`url`	Lenke til arrangementet.
`type`	Typen på norsk, for eksempel «Kurs». Se typene.
`title`, `description`	Tittel og beskrivelse.
`organizer`	Arrangøren.
`location`	Stedsnavnet.
`position`	`latitude`, `longitude`, `postalCode` og `postalArea`.
`image`	Lenke til bildet, når arrangementet har et.
`start`, `end`	Når arrangementet starter og slutter.
`sportName`	Seksjonen, for eksempel «Seilfly».
`signUpFee`	Påmeldingsavgiften i kroner.

Klubbstrømmen har i tillegg disse feltene:

Felt	Beskrivelse
`registrationUrl`	Lenke til påmeldingen.
`typeCode`	Typen som kode, for eksempel `WORKSHOP`.
`organizerOrgId`	Arrangørens organisasjons-ID.
`signUpStart`, `signUpEnd`	Når påmeldingen åpner og stenger.
`sportId`	Seksjonens ID. Se seksjonene.
`isIntroEvent`	`true` for arrangementer for nybegynnere.

Hele kalenderen som abonnement

GET kalender.nlf.no/ical

GET kalender.nlf.no/rss

Alle kommende arrangementer, som kalenderabonnement eller RSS. Lim adressen inn i kalenderen din (Outlook, Google Kalender, Apple Kalender) for å abonnere. Strømmene kan avgrenses med disse parameterne:

Parameter	Beskrivelse
`sections`	Seksjoner, ID-ene skilt med komma. `0` gir arrangementer uten seksjon. Se seksjonene.
`types`	Typer, kodene skilt med komma. Se typene.
`deadlines`	`include` tar med frister, `only` gir bare frister. Uten den: ingen frister.
`free`	`1` gir bare gratis arrangementer.
`intro`	`1` gir bare arrangementer for nybegynnere.
`reverse`	`true` gir de siste først.

For eksempel kurs i seilfly og fallskjerm: https://kalender.nlf.no/ical?sections=111,109&types=WORKSHOP

Seksjonene

ID	Seksjon
`109`	Fallskjerm
`110`	HPS (hang- og paraglider)
`111`	Seilfly
`235`	Ballong
`236`	Modellfly
`237`	Sportsfly
`238`	Motorfly
`0`	Ikke spesifisert

Typene

Kode	Type
`EVENT_UNOFFICIAL`	Arrangement
`EVENT_OFFICIAL`	Terminfestet arrangement
`MEETING`	Møte
`WORKSHOP`	Kurs
`EVENT_SERIES`	Serie
`LICENSE`	Lisens
`SCHOOL`	Skole
`AIRSHOW`	Airshow
`DEADLINE`	Tidsfrist (bare med `deadlines`)

Godt å vite

Feil i klubbstrømmen gir et JSON-svar med error og message: 400 når ingen gyldige ID-er er oppgitt, 405 for andre metoder enn GET.
Arrangementene hentes fra iSonen og fra enkelte klubber, og NLFs sekretariat legger inn større arrangementer selv. Endringer i iSonen kan bruke opptil 8 timer på å komme med.
Klubber kan også lage strømmen sin under «Integrer kalenderen» på kalender.nlf.no, uten å skrive adressen selv.