Локальный API сервера корта

Данные игр клуб забирает у себя: итоги матчей, замеры мяча, моменты и видео лежат на сервере корта в сети клуба и отдаются оттуда без интернета. Облако нужно для того, что живёт между клубами и в приложении игрока: брони, кошелёк, рейтинг.

Что откуда брать

В облако сервер корта отправляет только итоги матча, агрегаты статистики и клипы для приложения игрока (см. «Сервер корта и облако»). Полные записи, моменты со всех камер и сырые замеры мяча остаются в клубе — забрать их можно только локально.

Адрес

http://<адрес сервера корта>:8016

• Сервер корта доступен в сети клуба. Его адрес клуб получает при подключении; порт по умолчанию — 8016.
• Корт указывается своим именем, как он назван на сервере корта (например, «Корт 4»), в кодировке URL: %D0%9A%D0%BE%D1%80%D1%82%204. Список имён — в поле court_names ответа /status.
• Ответы — JSON в UTF-8. Часть ответов отдаётся теми же структурами, что видят экран корта и видеостена клуба, поэтому в них встречаются поля для показа (подписи, ссылки на миниатюры).

Ключ интеграции

Система клуба (1С, CRM, учёт, хранилище видео) передаёт ключ в заголовке X-Integration-Key. Ключ открывает только чтение данных игр из таблицы ниже. Управлять кортом по нему нельзя: счёт, состав, сессии, перезапуск служб, настройки камер, живое видео и звук остаются за PIN персонала.

curl "http://<адрес сервера корта>:8016/status" \
  -H "X-Integration-Key: <ключ интеграции>"

• Ключ выдаётся на систему: у 1С и у CRM — разные ключи, любой можно отозвать, не трогая остальные. Ключ создаётся на сервере корта и показывается один раз; в документации вместо него стоит заглушка <ключ интеграции>.
• Как получить: обратитесь к администратору вашей платформы — название клуба и какой системе нужен доступ. Новый и отозванный ключ начинают и перестают действовать после перезапуска служб сервера корта, который делается, когда на кортах нет игры.
• Неверный ключ, ключ на адресе вне списка и любой запрос, кроме GET, — 401 bad_pin.

Методы

Без ключа открыты GET /health (сервер жив, сколько кортов играет), GET /live.json (какие корты в эфире) и GET /live/{court}/state.json (идёт ли трансляция и счёт) — в них нет ничего, чего не видно на табло.

Поля ответов /measure/* пока названы по-русски (розыгрышей, скорость_макс_кмч, база_доступна). Если база_доступна: false — база замеров недоступна, и пустой ответ не означает, что розыгрышей не было.

После матча: итог и видео

S="http://<адрес сервера корта>:8016"
K="X-Integration-Key: <ключ интеграции>"
C="%D0%9A%D0%BE%D1%80%D1%82%204"          # «Корт 4»

# 1. Итог последнего матча на корте
curl -H "$K" "$S/match/summary?court=$C"
# → {"court": "Корт 4", "t0": 1790863200, "day": "2026-10-02", "time_from": "18:00", "time_to": "19:28",
#    "sets": [{"team1": 6, "team2": 4, "unfinished": false}, …], "winner": 1,
#    "players": [{"name": "Олег", "team": 1, "phone_tail": "0001", "distance_m": 2350.4,
#                 "top_speed_ms": 6.1, "sprints": 14, …}, …],
#    "highlights": [{"title": "…", "duration_s": 18, "ready": true, "url": "…"}],
#    "match_video": {"duration_s": 5280, "ready": true, "url": "…"}, …}

# 2. Разбор игроков этого матча (t0 — из итога)
curl -H "$K" "$S/match/report?court=$C&t0=1790863200"

# 3. Видео за сегодня: только полные записи матчей
curl -H "$K" "$S/archive/list.json?court=$C&kind=match&days=1"
# → {"items": [{"id": "…", "kind": "match", "day": "2026-10-02", "time": "18:00", "duration_s": 5280,
#               "cams": [{"cam": "hik101", "root": "rec", "path": "…", "size": 1834221568,
#                         "ready": true, …}], …}], "summaries": […], "truncated": false}

# 4. Скачать файл камеры (root и path — из списка, path в кодировке URL)
curl -H "$K" -o match.mp4 "$S/archive/file?root=<root>&path=<path>&download=1"

• Забирайте видео, пока оно на диске: запись хранится столько часов, сколько указано в retention_h ответа /rec/status (по умолчанию 72), потом удаляется.
• Файл с ready: false ещё дописывается — заберите позже.
• Итог отдаётся по последнему матчу корта. Чтобы не пропустить матчи, опрашивайте /archive/list.json: в поле summaries — итоги всех матчей за выбранные дни.

Ошибки

• 401 bad_pin — нет ключа, он неверен или метод не входит в чтение по ключу.
• 400 unknown_court — такого корта на сервере нет; 422 — не передан обязательный параметр (чаще всего court).
• 404 — нет итога (no_summary), сессии (no_session_on_court) или файла (not_found).