Разработчикам

Публичный REST API для клубов и сертифицированных партнёров: чтение с ограниченными правами, брони через API и вебхуки, подписанные HMAC.

Аутентификация

Каждый ключ создаётся в панели клуба, в разделе Настройки → Разработчикам, и передаётся как заголовок Bearer.

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

Полный ключ показывается только один раз. Сохраните его в надёжном месте.

Эндпоинты

Каждый ключ объявляет права, с которыми был создан; запрос без нужного права отклоняется.

GET/clubs/{clubId}/courts
Каталог кортов клуба.
GET/clubs/{clubId}/availability
Занятые интервалы по каждому корту, до 14 дней.
GET/clubs/{clubId}/bookings
Брони клуба, сначала самые новые.
GET/clubs/{clubId}/customers
Справочник клиентов клуба — персональные данные, за отдельным правом доступа.
POST/clubs/{clubId}/bookings
Создаёт бронь — так же, как ресепшен клуба.
POST/clubs/{clubId}/bookings/{bookingId}/cancel
Отменяет бронь; возвращает или аннулирует платёж согласно политике клуба.

Вебхуки

Получайте события, подписанные HMAC-SHA256, на свой URL: бронь создана, подтверждена или отменена, платёж успешен, матч укомплектован. Каждая доставка повторяется с задержкой; после нескольких неудачных попыток попадает в очередь неудачных доставок, которую можно переотправить из панели клуба.

Лимиты запросов

У каждого ключа есть лимит запросов в минуту. Ответ 429 означает, что лимит достигнут; замедлитесь и повторите попытку.

Сертифицированные партнёры

Сертифицированный партнёр подключается в один клик из панели клуба — без ручного копирования ключей.

Готовы подключить свой клуб?

Войдите в панель клуба и создайте первый ключ в разделе Настройки → Разработчикам.

Перейти в панель клуба Спецификация OpenAPI