Desarrolladores

Una API REST pública para clubes y socios certificados: lecturas con alcance, reservaciones por API y webhooks firmados con HMAC.

Autenticación

Cada llave se genera desde el panel del club, en Ajustes → Desarrolladores, y viaja como encabezado Bearer.

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

La llave completa solo se muestra una vez. Guárdala en un lugar seguro.

Endpoints

Cada llave declara los permisos con los que fue creada; una solicitud sin el permiso necesario se rechaza.

GET/clubs/{clubId}/courts
Catálogo de canchas del club.
GET/clubs/{clubId}/availability
Franjas ocupadas por cancha, hasta 14 días.
GET/clubs/{clubId}/bookings
Reservaciones del club, más recientes primero.
GET/clubs/{clubId}/customers
Directorio de clientes del club — datos personales, detrás de su propio permiso.
POST/clubs/{clubId}/bookings
Crea una reservación, igual que la mesa del club.
POST/clubs/{clubId}/bookings/{bookingId}/cancel
Cancela una reservación; reembolsa o anula el pago según la política del club.

Webhooks

Recibe eventos firmados con HMAC-SHA256 en tu propia URL: reservación creada, confirmada o cancelada, pago exitoso y partido completo. Cada entrega reintenta con retroceso; después de varios intentos fallidos pasa a la bandeja de fallidas, reenviable desde el panel del club.

Límites de uso

Cada llave tiene un límite de solicitudes por minuto. Una respuesta 429 significa que se alcanzó; reintenta más despacio.

Socios certificados

Un socio certificado se conecta con un clic desde el panel del club — sin copiar y pegar llaves a mano.

¿Listo para integrar tu club?

Inicia sesión en el panel del club y genera tu primera llave desde Ajustes → Desarrolladores.

Ir al panel del club Especificación OpenAPI