Интеграция с MATCHi
Приём событий MATCHi о бронях кортов: бронь создана, перенесена, отменена. Доступ — подпись MATCHi в заголовке x-matchi-signature.
Событие MATCHi о брони корта #
/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 | — | Успешный ответ; пример ниже |
| 401 | bad_signature | Подпись x-matchi-signature не сходится с секретом подписки клуба |
| 404 | not_configured | Связь с MATCHi у клуба не настроена (нет секрета подписки) |
| 400 | bad_json | Тело запроса — не JSON-объект |
| 413 | too_large | Тело запроса больше 256 КБ |
| 500 | processing_failed | Событие не обработано — MATCHi повторит его |
| 422 | […] | Ошибка проверки параметров или тела: detail — список ошибок |
Пример ответа
{"accepted": true, "outcome": "новая", "duplicate": false}