For utviklere

API-dokumentasjon

Sjakkturneringer har et offentlig, lesbart REST API for norske sjakkturneringer. Klubbnettsider bør vanligvis bruke innbyggingen, mens API-et passer for egne løsninger, statistikk, kart og integrasjoner.

Bygg inn på klubbside Åpne API

Base URL

https://sjakkturneringene.no/api/v1

API-et krever ingen API-nøkkel for vanlig lesing. Dataene kommer fra den lokale Sjakkturneringer-databasen, ikke fra direkte scraping av TournamentService.

Ansvarlig bruk

Cache svar lokalt når du bygger egne integrasjoner.
Ikke poll oftere enn nødvendig; turneringsdata endrer seg sjelden minutt for minutt.
Bruk JavaScript-innbyggingen hvis du bare skal vise turneringer på en klubbside.
Ta kontakt med Sjakkturneringer før større trafikk eller automatisk videredistribusjon.

Eksempler

Kan åpnes direkte i nettleseren

Kommende turneringer i Telemark

https://sjakkturneringene.no/api/v1/tournaments?fylke=telemark&status=upcoming

Vestfold og Telemark sammen

https://sjakkturneringene.no/api/v1/tournaments?fylke=vestfold&fylke=telemark&status=all

Kragerø-turneringer

https://sjakkturneringene.no/api/v1/tournaments?sted=kragero&status=all&limit=20

Innen 50 km fra Larvik

https://sjakkturneringene.no/api/v1/tournaments?latitude=59.0533&longitude=10.0352&radius_km=50&sort=distance

Detaljer for en turnering

https://sjakkturneringene.no/api/v1/tournaments/54/details

Tekstforslag til klubbinnlegg

https://sjakkturneringene.no/api/v1/share/tournaments?fylke=telemark&days=60&limit=6&link_mode=source_short

Endepunkter

Alle svar er JSON

GET/tournaments

Søk i turneringer med fylke, sted, arrangør, dato, status og avstand.

GET/tournaments/{id}

Hent én turnering med normalisert sted, dato, status og lenker.

GET/tournaments/{id}/details

Hent lagrede deltakere, resultater og partier når dette finnes.

GET/counties

Hent fylker som kan brukes som filterverdier.

GET/cities

Hent steder som kan brukes som filterverdier.

GET/places

Hent steder med fylke, kommune, koordinater og antall turneringer.

GET/organizers

Hent arrangører som kan brukes som filterverdier.

GET/stats

Hent en enkel totalsum fordelt på status.

GET/data-health

Se dekning, synkronisering og parserstatus for lagrede data.

GET/share/tournaments

Lag tekst og HTML for klubbinnlegg basert på samme filtre som turneringssøket.

Filtre for turneringssøk

https://sjakkturneringene.no/api/v1/tournaments

Parameter	Eksempel	Forklaring
`fylke eller county`	telemark	Kan gjentas eller skrives kommaseparert for flere fylker.
`sted eller city`	kragero	Kan gjentas eller skrives kommaseparert for flere steder.
`arrangor eller organizer`	kragero-sjakklubb-ungdom	Kan gjentas eller skrives kommaseparert for flere arrangører.
`status`	upcoming	upcoming, ongoing, finished, cancelled eller all.
`search`	grand prix	Fritekstsøk i navn, sted og arrangør.
`from`	2026-09-01	Fra og med dato.
`to`	2026-12-31	Til og med dato.
`type`	rapid	Turneringstype når den er kjent.
`bgp, ngp, fide_rated`	true	Filtrer på ja/nei-flagg.
`latitude og longitude`	59.0533 / 10.0352	Må brukes sammen for avstandssøk.
`radius_km`	50	Brukes sammen med latitude og longitude.
`sort`	start_date	start_date, -start_date, name, -name, updated, -updated eller distance.
`limit`	25	1 til 100 resultater.
`offset`	0	Brukes for paginering.

Responsformat

Forkortet eksempel

{
  "count": 73,
  "limit": 20,
  "offset": 0,
  "items": [
    {
      "id": 54,
      "name": "Kragerø Grand Prix 2026 - VT TOUR",
      "start_date": "2026-09-04",
      "end_date": "2026-09-06",
      "city": "Kragerø",
      "county": { "slug": "telemark", "name": "Telemark" },
      "status": "finished",
      "links": {
        "source": "https://tournamentservice.com/...",
        "clono": "https://clono.no/live/tournament/?t_id=1598"
      }
    }
  ]
}

Bruk `count`, `limit` og `offset` for paginering. Turneringens `id` er den stabile lokale ID-en som brukes i nettsiden og detaljendepunktet.

Varslingsendepunktene som PWA-en bruker er ikke ment som et offentlig integrasjons-API for klubbnettsider.