Sviluppatori

Un'API REST pubblica per club e partner certificati: letture con ambito definito, prenotazioni via API e webhook firmati con HMAC.

Autenticazione

Ogni chiave viene generata dal pannello del club, in Impostazioni → Sviluppatori, e viaggia come intestazione Bearer.

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

La chiave completa viene mostrata una sola volta. Conservala in un posto sicuro.

Endpoint

Ogni chiave dichiara gli ambiti con cui è stata creata; una richiesta senza l'ambito necessario viene rifiutata.

GET/clubs/{clubId}/courts
Il catalogo dei campi del club.
GET/clubs/{clubId}/availability
Fasce occupate per campo, fino a 14 giorni.
GET/clubs/{clubId}/bookings
Le prenotazioni del club, più recenti prima.
GET/clubs/{clubId}/customers
La rubrica clienti del club — dati personali, dietro un ambito proprio.
POST/clubs/{clubId}/bookings
Crea una prenotazione, come alla reception del club.
POST/clubs/{clubId}/bookings/{bookingId}/cancel
Annulla una prenotazione; rimborsa o annulla il pagamento secondo la politica del club.

Webhook

Ricevi eventi firmati con HMAC-SHA256 sul tuo URL: prenotazione creata, confermata o annullata, pagamento riuscito e partita al completo. Ogni consegna riprova con backoff; dopo diversi tentativi falliti finisce nella coda delle consegne fallite, riconsegnabile dal pannello del club.

Limiti di utilizzo

Ogni chiave ha un limite di richieste al minuto. Una risposta 429 significa che è stato raggiunto; rallenta e riprova.

Partner certificati

Un partner certificato si connette con un clic dal pannello del club — senza copiare e incollare chiavi a mano.

Pronto a integrare il tuo club?

Accedi al pannello del club e genera la tua prima chiave in Impostazioni → Sviluppatori.

Vai al pannello del club Specifica OpenAPI