DA
Log ind Book en demo
Udviklere

Et REST API bygget til anlægsdata med flere kunder

Treogtyve versionerede endpoints under /api/v1. Bearer-godkendelse, afgrænsede rettigheder, rate-limits per token og en revisionslog på hvert kald.

Godkendelse
# Opret et token under Dashboard → Integrationer.
# Hemmeligheden vises én gang og gemmes som et SHA-256-hash.

curl https://kourtiva.com/api/v1/me \
  -H "Authorization: Bearer $KOURTIVA_TOKEN"

# 401 ved et ugyldigt, udløbet eller tilbagekaldt token.
# 403 når tokenet mangler den nødvendige rettighed.
# 429 når grænsen for antal kald er overskredet.
api.kourtiva.com GET/v1/courts/availability Authorization: Bearer kv_live_•••• 200OK · 34ms { "venue": "vn_8832a", "courts": [ { "id": "crt_01", "sport": "padel", "free": ["19:00", "21:00"] }, { "id": "crt_02", "sport": "tennis", "free": ["18:00"] } ] }

Sikkerhed der ikke er valgfri

  • Hemmeligheder gemmes hashet — et databaselæk giver intet brugbart token
  • HTTPS håndhæves; almindelig HTTP afvises frem for at blive omdirigeret
  • Rettigheder per token, så en rapporteringsintegration ikke kan skrive
  • Valgfrie udløbsdatoer, og tilbagekaldelse der træder i kraft med det samme
  • Kunden bestemmes på serversiden — et anlægs-id accepteres aldrig fra en klient
  • Metode, sti, status, varighed og token registreres for hver forespørgsel
Ressourcer

Hvad du kan læse og skrive

Bookinger

Vis, undersøg og filtrér reservationer på tværs af dine baner, inklusive check-in-status.

Baner og tidsrum

Banedefinitioner og deres bookbare tidsrum, med tilgængelighed per dato.

Sportsgrene og faciliteter

De sportsgrene du tilbyder, og de faciliteter der hører til hvert anlæg.

Medlemmer

De spillere der er registreret på dit anlæg, med deres bookinghistorik.

Fakturaer og betalinger

Økonomiske poster knyttet til de bookinger der skabte dem.

Turneringer

Konkurrencer, tilmeldte hold og kampprogrammer.

Besøgende

Besøgstal og opsummeringer til belægningsrapportering.

Anlægsprofil

Din egen anlægspost — den kunde tokenet peger på.

Versioneret, så opgraderinger er dine at planlægge

Alt ligger under /api/v1. Brydende ændringer udgives som en ny version frem for at dukke uanmeldt op i den, du allerede har integreret mod.

Anmod om API-adgang
Banetilgængelighed
GET /api/v1/courts/12/slots?date=2026-08-09

{
  "data": [
    { "starts_at": "08:00", "available": true  },
    { "starts_at": "09:00", "available": false },
    { "starts_at": "10:00", "available": true  }
  ]
}

Mangler du et endpoint vi ikke har?

Fortæl os hvad du integrerer med, så kigger vi på det.

Book en demo Udforsk funktioner
Book en privat demo