Badstat API

API-et er gratis og bare for lesing. Alle svar er JSON, og alle kall er GET. Oppgi «Data fra Badstat» med lenke til badstat.no der dataene vises.

https://kfxdblvdunnrxhuxqvzi.supabase.co/functions/v1/public-api

curl -H "X-API-Key: bs_dinnøkkel" \
  "https://kfxdblvdunnrxhuxqvzi.supabase.co/functions/v1/public-api/v1/players?search=Brynjar"

Alle kall krever en API-nøkkel i headeren X-API-Key (eller Authorization: Bearer …). Send en e-post med hva du skal bruke dataene til, så får du en. Hold nøkkelen på serveren din hvis du kan.

Hver nøkkel kan gjøre 60 kall i minuttet. Over grensen får du 429 med Retry-After (sekunder). Svar kan caches i 5 minutter.

Det er ingen grense på hvor mange kamper du kan hente per spiller – bare maks 200 per kall. Bruk offset for å bla.

• Kamper og turneringer hentes fra badmintonportalen hver natt (ca. kl. 04–05). En kamp spilt i dag ligger normalt inne neste morgen.
• Ranking oppdateres når Norges Badmintonforbund publiserer en ny rankingversjon. ranking_date viser hvilken versjon du ser.

Det finnes ingen sanntidsdata – rankingen endrer seg ikke underveis i en turnering. GET /v1 viser når data sist ble oppdatert.

Badmintonportalen gir samme person to ID-er: spillernummeret i rankingen (6 sifre, f.eks. 109614) og en intern ID i kampene (f.eks. 36427). API-et kobler dem sammen, så begge ID-ene gir samme spiller, kamper og statistikk. linked_ids viser hvilke som hører sammen. Et søk kan derfor vise samme person to ganger – bruk gjerne ID-en med ranking som fast nøkkel.

Kamper fra før 2025/26 har ofte bare navn, ikke ID, og kobles på navn. To spillere med nøyaktig samme navn kan derfor få hverandres eldre kamper, slik som på badstat.no.

Alle stier er relative til base-URL-en. Kategorier: HS herresingle, DS damesingle, HD herredouble, DD damedouble, MIX mixed.

Feil kommer som JSON med en fast kode og en lesbar melding:

{ "error": { "code": "invalid_parameter", "message": "season must look like 2025/2026" } }

For en kamplogg: hent hele historikken én gang, og deretter bare inneværende sesong hver natt. Bruk kampens id for å hoppe over kamper du allerede har.

const BASE = 'https://kfxdblvdunnrxhuxqvzi.supabase.co/functions/v1/public-api/v1';
const headers = { 'X-API-Key': process.env.BADSTAT_API_KEY };

// Hent alle kampene til en spiller i en sesong (blar gjennom sidene)
async function seasonMatches(playerId, season) {
  const all = [];
  for (let offset = 0; ; offset += 200) {
    const url = `${BASE}/players/${playerId}/matches` +
      `?season=${encodeURIComponent(season)}&limit=200&offset=${offset}`;
    const res = await fetch(url, { headers });
    if (!res.ok) throw new Error((await res.json()).error.message);
    const { data, meta } = await res.json();
    all.push(...data);
    if (all.length >= meta.total || data.length === 0) return all;
  }
}