Заявки

Заявки с сайта, из рекламы или со стойки клуба. Публичный метод.

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

Заявка с сайта, из рекламы или со стойки #

POST/v1/leads

Доступ: Публичный Без авторизации.

Заявка с сайта, из рекламы или со стойки — без входа. Повтор с тем же телефоном и клубом в течение 24 часов не создаёт новую заявку: возвращается прежняя с duplicate=true. Если человек уже зарегистрирован, заявка связывается с ним. Источник и UTM-метки нужны для отчёта о привлечении клуба.

Тело запроса `application/json`

Поле	Тип	Обязательно	Описание
`phone`	строка	да	Телефон (российский номер) длина от 5; длина до 32
`name`	строка	нет	Имя длина до 80
`club_id`	строка, или null	нет	Клуб, куда заявка длина до 24
`source`	строка	нет	Источник: сайт, реклама, стойка и т. п. длина до 60
`utm`	объект, или null	нет	UTM-метки объектом
`comment`	строка	нет	Комментарий, до 300 символов длина до 300

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

curl -X POST "https://адрес-вашего-сервера/api/v1/leads" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+79000000001",
  "name": "Мария",
  "club_id": "c1",
  "source": "site",
  "utm": {"utm_source": "yandex", "utm_campaign": "autumn"},
  "comment": "Хочу пробную тренировку"
}'

Ответы

Код	detail	Значение
200	—	Успешный ответ; пример ниже
400	`bad_phone`	Телефон не распознан (нужен российский номер +7…)
404	`club_not_found`	Клуб не найден
422	[…]	Ошибка проверки параметров или тела: detail — список ошибок

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