Utviklere

Et offentlig REST-API for klubber og sertifiserte partnere: avgrenset lesing, bookinger via API og HMAC-signerte webhooks.

Snakk om en integrasjon

Autentisering

Hver nøkkel genereres fra klubbpanelet, under Administrasjon → API og webhooks, og sendes som en Bearer-header.

curl -H "Authorization: Bearer mp_…" \
  https://api.meetandplay.mx/api/v1/clubs/{clubId}/bookings

Den fullstendige nøkkelen vises bare én gang. Lagre den et trygt sted.

Endepunkter

Hver nøkkel oppgir omfangene (scopes) den ble opprettet med. En forespørsel uten nødvendig omfang avvises.

GET/clubs/{clubId}/courts
Klubbens baneoversikt.
GET/clubs/{clubId}/availability
Opptatte tider per bane, opptil 14 dager.
GET/clubs/{clubId}/bookings
Klubbens bookinger, nyeste først.
GET/clubs/{clubId}/customers
Klubbens kundeoversikt – personopplysninger, bak et eget omfang.
POST/clubs/{clubId}/bookings
Oppretter en booking, på samme måte som klubbens egen resepsjon.
POST/clubs/{clubId}/bookings/{bookingId}/cancel
Avbestiller en booking. Refunderer eller annullerer betalingen i henhold til klubbens regler.

Webhooks

Motta HMAC-SHA256-signerte hendelser på din egen URL: booking opprettet, bekreftet eller avbestilt, betaling gjennomført og kamp fylt. Hver levering forsøkes på nytt med økende pauser. Etter flere mislykkede forsøk havner den i dead-letter-køen, og kan leveres på nytt fra klubbpanelet.

Webhook-autentisering

I tillegg til HMAC-signaturen (x-map-signature) kan hver webhook sende en Authorization-header, enten Basic (brukernavn og passord) eller Bearer (token). Sett den opp i klubbpanelet, under Administrasjon → API og webhooks, i hver webhooks autentisering. Legitimasjonen lagres kryptert og vises aldri igjen.

POST https://…/webhooks
x-map-signature: t=1767225600,v1=…
x-map-delivery: 0199…
Authorization: Bearer …

Den sendes ved hver levering, også ved nye forsøk og ny levering fra dead-letter-køen, med legitimasjonen som gjelder på sendetidspunktet: hvis du endrer eller fjerner den, gjelder endringen også for leveringer som allerede ligger i køen. Hvis serveren ikke kan dekryptere legitimasjonen, sendes leveringen aldri uten den, men havner i dead-letter-køen. Hvis du endrer URL-en eller sletter webhooken, blir leveringer i kø for den gamle URL-en avbrutt eller flyttet til dead-letter-køen: legitimasjonen sendes aldri til en URL du ikke lenger har registrert.
Vi anbefaler fortsatt å verifisere HMAC-signaturen: Authorization-headeren sier hvem som kaller, men bare signaturen beviser at innholdet ikke er endret, og tidsstempelet (t=) lar deg avvise gjentatte leveringer.
Omdirigeringer følges ikke: et 3xx-svar regnes som en mislykket levering og forsøkes på nytt, slik at legitimasjonen aldri sendes til en annen URL. Registrer mottakerens endelige URL.

Forespørselsgrenser

Hver nøkkel har en grense for forespørsler per minutt. Et 429-svar betyr at grensen er nådd. Ta det roligere og prøv igjen.

Sertifiserte partnere

En sertifisert partner kobler seg til med ett klikk fra klubbpanelet – ingen nøkler som kopieres og limes inn for hånd.

Klar til å integrere klubben din?

Logg inn på klubbpanelet og lag din første nøkkel under Administrasjon → API og webhooks.

Gå til klubbpanelet OpenAPI-spesifikasjon