Kvam Disc Golf API

Introduksjon

Kom i gang

Kvam Disc Golf API gir tilgang til vår disc golf-database: plastikk, molds, merke og flygtall. Data frå over 400 diskar og 150+ plastikk-variantar.

Alle kall krev ein API-nøkkel. Du får nøkkelen gratis ved å registrere e-postadressa di nedanfor.

1

Registrer deg

Fyll inn skjemaet under POST /v1/register. Du får ein nøkkel på e-post.

2

Legg ved nøkkelen

Send nøkkelen med kvar førespurnad i headeren x-api-key.

3

Hent data

Alle endepunkt returnerer JSON med data-array, total, limit og offset.

Autentisering

API-nøkkel

Send nøkkelen i ein av desse to headrane:

# Tilrådd
x-api-key: kvam_abc123…

# Alternativt
Authorization: Bearer kvam_abc123…

60 førespurnadar / minutt per nøkkel

Treng du høgare grense? Ta kontakt på api@kvamdgs.no.

Endepunkt

Registrer API-nøkkel

Registrer e-postadressa di for å få ein API-nøkkel. Ingen betaling krevst.

POST /v1/register Ingen autentisering nødvendig

Body-parametrar

Felt	Type	Beskriving
email	string	E-postadressa di
name	string	Namn / organisasjon
use_casevalgfri	string	Korleis du planlegg å bruke API-et

Eksempel

curl -X POST https://api.kvamdgs.no/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dev@example.com",
    "name": "Ola Utviklar",
    "use_case": "Disc golf-app"
  }'

// Svar 201
{
  "key": "kvam_a1b2c3d4…",
  "email": "dev@example.com",
  "rate_limit_per_min": 60
}

Registrer deg her

E-postadresse

Namn / organisasjon

Bruksområde (valfritt)

Nøkkelen vert sendt til e-posten din. Ingen spam, ingen betaling.

Endepunkt

Merke

Returnerer alle disc golf-merke i databasen.

GET /v1/brands Krev x-api-key

Query-parametrar

Param	Type	Standard
limitvalgfri	integer	200 (maks 500)
offsetvalgfri	integer	0

Svar

{
  "data": [
    {
      "name": "Discmania",
      "slug": "discmania",
      "country": "Finland",
      "website": "https://discmania.net",
      "logo_url": "…",
      "description": "…"
    }
  ],
  "total": 24,
  "limit": 200,
  "offset": 0
}

Endepunkt

Plastikk

Alle plastikk-variantar med haldbarheit, plastikkfamilie og glow-status.

GET /v1/plastics Krev x-api-key

Query-parametrar

Param	Type	Beskriving
brandvalgfri	string	Filter på merkenamn, f.eks. `Discmania`
limitvalgfri	integer	100 (maks 500)
offsetvalgfri	integer	0

Svar

{
  "data": [
    {
      "name": "C-Line",
      "slug": "c-line",
      "brand": "Discmania",
      "family": "C-Line",
      "durability_tier": "premium",
      "plastic_type": null,
      "description": "…",
      "is_glow": false
    }
  ],
  "total": 156,
  "limit": 100,
  "offset": 0
}

Endepunkt

Molds

Disc-molds med flygtall (speed, glide, turn, fade).

GET /v1/molds Krev x-api-key

Query-parametrar

Param	Type	Beskriving
brandvalgfri	string	Filter på merke
disc_typevalgfri	string	`distance_driver` / `fairway_driver` / `midrange` / `approach` / `putter`
limitvalgfri	integer	100 (maks 500)
offsetvalgfri	integer	0

Svar

{
  "data": [
    {
      "name": "FD",
      "slug": "fd",
      "brand": "Discmania",
      "speed": 7,
      "glide": 6,
      "turn": -1,
      "fade": 1,
      "pdga_approved": true
    }
  ],
  "total": 312,
  "limit": 100,
  "offset": 0
}

Endepunkt

Diskkataloget

Søk og filtrer i heile diskkataloget med kombinerte flygtall-filter.

GET /v1/discs Krev x-api-key

Query-parametrar

Param	Type	Beskriving
brandvalgfri	string	Merkenamn
plasticvalgfri	string	Plastikknamn
moldvalgfri	string	Mold-namn
disc_typevalgfri	string	distance_driver / fairway_driver / midrange / approach / putter
speed_min / speed_maxvalgfri	integer	Speed-range (1–15)
glide_min / glide_maxvalgfri	integer	Glide-range (1–7)
turn_min / turn_maxvalgfri	number	Turn-range (−5 til 1)
fade_min / fade_maxvalgfri	integer	Fade-range (0–5)
is_glowvalgfri	boolean	true for glow-plastikk
limitvalgfri	integer	50 (maks 200)
offsetvalgfri	integer	0

Eksempel — understable fairways

GET /v1/discs?disc_type=fairway_driver
  &turn_min=-3&turn_max=-1
  &limit=5

// Svar
{
  "data": [
    {
      "handle": "discmania-c-line-fd",
      "title": "Discmania C-Line FD",
      "brand": "Discmania",
      "mold": "FD",
      "plastic": "C-Line",
      "plastic_family": "C-Line",
      "speed": 7,
      "glide": 6,
      "turn": -1,
      "fade": 1,
      "disc_category": "fairway_driver",
      "stability_category": "understable",
      "skill_level": "intermediate",
      "is_glow": false
    }
  ],
  "total": 48,
  "limit": 5,
  "offset": 0
}

Referanse

Feilkoder

Alle feil returnerer JSON med eit message-felt.

Statuskode	Beskriving
200 / 201	Vellykka
400	Ugyldig førespurnad — sjekk body/parametrar
401	Nøkkel manglar eller er ugyldig
409	E-post allereie registrert
429	Rate limit nådd — vent eit minutt
500	Intern feil — ta kontakt viss det held fram