AI ПаделДокументация API На сайт

Интеграция с MATCHi

Приём событий MATCHi о бронях кортов: бронь создана, перенесена, отменена. Доступ — подпись MATCHi в заголовке x-matchi-signature.

Базовый адрес: https://адрес-вашего-сервера/api · Руководство по разделу: Системы бронирования

Событие MATCHi о брони корта #

POST/v1/integrations/matchi/{club_id}

Доступ: Подпись MATCHi Заголовок x-matchi-signature — HMAC-SHA256 тела запроса секретом подписки на события MATCHi, в шестнадцатеричном виде. Секрет выдаёт поддержка MATCHi; клуб вводит его в своей панели.

Адрес подписки клуба club_id на события MATCHi (Matchi Event Portal). Тело — конверт MATCHi {id, detail-type, timestamp, detail}. Принимаются BookingCreated, BookingMoved и BookingCancelled версий V1 и V2: бронь MATCHi создаёт, переносит или отменяет бронь корта у нас — корт не продаётся дважды, по брони включается запись на корте, ролики и статистика уходят игрокам. Корт MATCHi (courtId) сопоставляется с кортом клуба вручную в панели клуба или по названию; время приходит по UTC и переводится в часы клуба; игрок — отдельная запись игрока MATCHi по его номеру клиента в MATCHi (телефон из MATCHi не подтверждён и для привязки к аккаунту не используется). Событие с уже принятым id повторно не выполняется (duplicate=true), поэтому повторная доставка MATCHi безопасна. Если связь выключена в панели клуба — ответ 200 с accepted=false.

Параметры пути

ИмяТипОбязательноОписание
club_idстрокадаИдентификатор клуба

Пример запроса

curl -X POST "https://адрес-вашего-сервера/api/v1/integrations/matchi/c1"

Ответы

КодdetailЗначение
200—Успешный ответ; пример ниже
401bad_signatureПодпись x-matchi-signature не сходится с секретом подписки клуба
404not_configuredСвязь с MATCHi у клуба не настроена (нет секрета подписки)
400bad_jsonТело запроса — не JSON-объект
413too_largeТело запроса больше 256 КБ
500processing_failedСобытие не обработано — MATCHi повторит его
422[…]Ошибка проверки параметров или тела: detail — список ошибок

Пример ответа

{"accepted": true, "outcome": "новая", "duplicate": false}