Skip to content

Войти по номеру телефона и OTP

Request

Приглашение MASTER/ADMIN принимается однократно. Повторная или проигравшая конкурентная попытка нового сотрудника возвращает 404 invite_code_not_found. Существующий сотрудник входит по своему подтверждённому контакту без повторного принятия приглашения.

Авторизует пользователя по номеру телефона и OTP-коду. Email необязателен для всех ролей. Только CLIENT, независимый MASTER и SALON OWNER без подтверждённого email получают is_active=false, verify_next=EMAIL и могут завершить регистрацию позже. SALON MASTER, SALON ADMIN, системный ADMIN и REFERRAL_RECRUITER сразу получают is_active=true, verify_next=null даже без email. JWT и RT работают в пределах прав роли. PENDING_PHONE по-прежнему требует подтверждения телефона.

Допустимые значения: CLIENT, MASTER, SALON, ADMIN, REFERRAL_RECRUITER. ADMIN разрешён только для ранее созданного аккаунта и не регистрируется автоматически. При первом входе с REFERRAL_RECRUITER аккаунт регистрируется автоматически. Если привязки ещё нет, по подтверждённому телефону ищется бизнес с полными регистрационными данными: сначала аккаунт владельца салона, затем независимого мастера. Реквизиты и сведения DaData не обязательны. Если подходящего бизнеса нет, реферальный аккаунт остаётся пустым. Существующая привязка не заменяется. Если type_account = SALON, клиент обязан передать role_in_salon. Допустимые значения: OWNER, MASTER, ADMIN. При создании нового аккаунта с role_in_salon = MASTER или ADMIN клиент обязан передать invite_token. Для входа в существующий аккаунт токен не обязателен.

Необязательное поле referral_code обрабатывается только при создании нового аккаунта. Его могут использовать клиент (CLIENT), индивидуальный мастер (MASTER) и владелец салона (SALON с role_in_salon = OWNER). Для мастера и администратора салона (SALON с role_in_salon = MASTER или ADMIN) реферальный код игнорируется. Если рефовод с указанным ID не существует, аккаунт создаётся без рефовода.

При входе в уже существующий аккаунт referral_code игнорируется. Если аккаунт был удалён и затем создан повторно с тем же телефоном, сохраняется первоначальный рефовод и прежний статус реферала: новый код не может заменить историческую привязку и повторная награда не начисляется.

В успешном ответе возвращает пару токенов:

  • JWT - access token
  • RT - refresh token Отдельный business_invite_token разрешён только CLIENT и несовместим с непустыми referral_code и invite_token. Некорректный или недоступный MASTER:id / SALON:id даёт invalid_body на этапе валидации. Для валидного идентификатора отказ бизнес-программы (например, ALREADY_BOUND_TO_OTHER_BUSINESS) не блокирует вход и сохраняется в списке бизнеса; персональная рефералка и купоны автоматически не запускаются. Для платной реферальной системы клиент передаёт только referral_invite_code. Он несовместим с кодами других программ. Привязка создаётся только при первой регистрации; повторный вход её не меняет. Для первой услуги отведено 90 дней, затем после её COMPLETED начисления действуют 180 дней.
Bodyapplication/jsonrequired
phonestring, <= 32 charactersrequired
Example:"+79991234567"
otpstring, = 6 characters^\d{6}$required

Одноразовый код подтверждения

Example:"123456"
type_accountstring(AuthTypeAccount)required

Тип аккаунта для входа по телефону. ADMIN возможен только для существующего аккаунта.

Enum:"CLIENT""MASTER""SALON""ADMIN""REFERRAL_RECRUITER"
Example:"CLIENT"
role_in_salonstring or null(SalonMemberRole)

Роль внутри салона. Обязательна при type_account = SALON.

Enum:"OWNER""MASTER""ADMIN"
Example:"MASTER"
invite_tokenstring or null

Токен приглашения. Обязателен при создании нового аккаунта с type_account = SALON и role_in_salon = MASTER или ADMIN; при входе в существующий аккаунт не обязателен.

Example:"eyJpbnZpdGUiOiIxMjMifQ"
referral_codestring or null^\d+$

Необязательный ID рефовода. Применяется только при создании аккаунта CLIENT, MASTER или владельца салона (SALON + OWNER). При входе в существующий аккаунт, а также для мастера или администратора салона поле игнорируется. Несуществующий код не мешает регистрации. Повторная регистрация с тем же телефоном восстанавливает первоначальную привязку независимо от переданного нового кода.

Example:"42"
business_invite_tokenstring or null, <= 2048 characters

Идентификатор бизнеса из ссылки профиля: MASTER:456 (user ID мастера) или SALON:123 (ID салона). Проверяются формат, существование и доступность бизнеса. Старые context_token не принимаются. 70 дней отсчитываются от регистрации с приглашением, повторный вход срок не продлевает. Только CLIENT. Нельзя одновременно передавать непустой referral_code или staff invite_token: это invalid_body до проверки OTP. Пустое/null значение не включает бизнес-приглашение. Новый клиент получает атрибуцию пригласившего бизнеса; существующий клиент проходит обычный вход, а результат попытки сохраняется отдельно. Отказ из-за активной или прошлой чужой привязки не меняет токены входа и не переносит прежнюю привязку.

referral_invite_codestring or null^[0-9a-f]{32}$

Код ссылки платной реферальной системы. Применяется только при первой регистрации CLIENT, MASTER или владельца SALON. Несовместим с referral_code, business_invite_token и invite_token. Первая услуга должна стать COMPLETED до истечения 90 дней; затем действует отдельное 180-дневное окно начислений.

curl -i -X POST \
  https://felmee.com/api/auth/phone/login \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "+79991234567",
    "otp": "123456",
    "type_account": "CLIENT",
    "role_in_salon": null,
    "invite_token": null,
    "referral_code": "42"
  }'

Responses

Авторизация выполнена успешно

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(TokenPair)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "success": true, "message": "The authorization process has been completed successfully!", "codeError": null, "error_code": null, "data": { "JWT": "<access_token>", "RT": "<refresh_token>", "is_active": true, "verify_next": null } }