Игроки

Профиль игрока и знакомые игроки. Доступ — токен игрока.

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

Знакомые игроки #

GET/v1/players/recent

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

С кем игрок уже играл (партнёры и соперники) и взаимные пары подбора — до 20 человек, недавние первыми. Нужен, чтобы позвать человека разделить оплату. Телефоны не отдаются.

Заголовки

Имя	Тип	Обязательно	Описание
`Authorization`	строка	да	Bearer <токен игрока>

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

curl -X GET "https://адрес-вашего-сервера/api/v1/players/recent" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Код	detail	Значение
200	—	Успешный ответ; пример ниже
401	`no_token`	Нет токена в заголовке Authorization
401	`invalid_token`	Токен просрочен или подделан — обновите его через `/v1/auth/refresh`

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

{
  "items": [
    {
      "id": "a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15",
      "name": "Анна С.",
      "level": "C",
      "photoUrl": null
    }
  ]
}

Профиль игрока #

GET/v1/players/{player_id}

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Публичный профиль игрока: уровень, рейтинг, последние 5 матчей и до 12 видео с явно открытой ссылкой. Видео с корта по подписанной ссылке здесь не выдаются.

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

Имя	Тип	Обязательно	Описание
`player_id`	строка (uuid)	да	Идентификатор игрока

Заголовки

Имя	Тип	Обязательно	Описание
`Authorization`	строка	да	Bearer <токен игрока>

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

curl -X GET "https://адрес-вашего-сервера/api/v1/players/a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

Код	detail	Значение
200	—	Успешный ответ
401	`no_token`	Нет токена в заголовке Authorization
401	`invalid_token`	Токен просрочен или подделан — обновите его через `/v1/auth/refresh`
404	`player_not_found: …`	Игрок не найден (в тексте — его идентификатор или телефон)
422	[…]	Ошибка проверки параметров или тела: detail — список ошибок