Anleggsregister (AR)
Introduksjon
Her finner du metoder som inneholder informasjon om anlegg, haller, lokasjoner for idrett og arenadetaljer
Forskjeller fra anleggsregisteret til KUD
I utgangspunktet er disse to registerne identiske. Men det kan allikevel være avvik da vi ikke synkronierer med KUD. NIF har også en større modell enn KUD.
Verdt å vite: I vårt register har vi i utgangspunktet tre nivåer:
Venue: Et helt anleggsområde. Som f.eks Ekeberg. Dette nivået finnes ofte ikke hos KUD. Man kan allikevel finne hall/bane i dette nivået da det er naturlig at det ikke er et område, men en faktisk hall/bane o.l.
VenueUnit: Selve hallen, som da finnes på en venue. Dette er ofte den enheten som er linket opp mot KUD sitt register. Hvis vi har en match her så eksponeres KUD Id’en i dette informasjonslaget
PhysicalArea: Her er selve flateinndelingen i f.eks en hall. Dette informasjonsobjektet er tett knyttet opp til selve idretten som skal utføres. Og en Unit kan ha mange inndelinger.
Dokumentasjon og endepunkter
URL | Miljø | Kommentar |
|---|---|---|
https://datadst.nif.no/ | DST / Staging | Base URL |
https://data.nif.no/ | Produksjon | Base URL |
Metoder tilgjengelig
Metode | Innhold | URL | Type | Parametere | Scope |
|---|---|---|---|---|---|
Venue | Viser informasjon om lokasjonen kampen spilles på | /api/v1/ta/Venue | GET, paramterstyrt | VenueID eller VenueNo | data_venue_read |
PhysicalArea | Viser informasjon om banedel/baneområde kampen spilles på i lokasjonen hentet fra Match eller Tournamentmatches. | /api/v1/ta/PhysicalArea | GET, paramterstyrt | PhysicalAreaID | data_venue_read |
VenueUnit | Viser informasjon om selve banen eller hallen | /api/v1/ta/VenueUnit | GET, paramterstyrt | VenueUnitId | data_venue_read |
VenueUnits | Viser informasjon om alle banene eller haller på lokasjonen (venue) | /api/v1/venues/VenueUnits | GET, paramterstyrt | VenueId | data_venue_read |
ScheduledMatches/byVenue | Viser informasjon om hvilke kamper (FRA TA), som spilles på i anlegget | /api/v1/venues/shceduledmatches/ByVenue | GET, paramterstyrt | VenueId, eller VenueUnitId | data_venuematches_read |
allVenues | Viser alle anlegg som er registrert hos NIF | /api/v1/venues/allVenues | Get |
| data_venue_read |
VenueSearch | Søkbar tjeneste for venues | /api/v1/venues/search | Post |
| data_venue_read |
Reservations | Søkbar tjeneste for reservasjoner i en VenueUnit eller PhysicalArea | /api/v1/ta/reservations | Post | Flere parametere mulig | data_reservations_read |
Tjenestene har litt ulik mappestruktur i url, da de initielt ble laget for å støtte TA domenet. Venue har nå fått et eget domene i data_nif, men for å støtte bakoverkompabilitet har vi valgt å la URL’ene på de eksisterende metodene forbli urørt.