Skip to content

Получить ссылку приглашения в салон

Request

Возвращает invite-ссылку для регистрации мастера или администратора салона.

Backend получает или создает raw invite token в Redis по паре role_in_salon + salon_role_id, после чего возвращает готовую ссылку вида /api/auth/phone/login?invite_code={token} с доменом приложения.

Если ссылка для этой пары уже существует и Redis payload еще не истек, backend возвращает ту же ссылку и не создает новый token.

salon_role_id - это ID сущности роли в салоне:

  • при role_in_salon = MASTER передается salon_masters.id
  • при role_in_salon = ADMIN передается salon_admins.id

Правила валидации:

  • role_in_salon должен быть MASTER или ADMIN
  • salon_role_id должен быть положительным числом
  • target entity должен существовать
  • target entity должен быть привязан к салону и пользователю
  • пользователь target entity еще не должен иметь phone

Требования:

  • требуется JWT
  • текущий пользователь должен иметь доступ к salon endpoints
Security
bearerAuth or jwtCookie
Query
role_in_salonstring(SalonInviteRoleInSalon)

Роль приглашения в салоне. Допустимы только MASTER и ADMIN.

Enum:"MASTER""ADMIN"
Example:role_in_salon=MASTER
salon_role_idinteger, (int64), >= 1

ID salon_masters.id или salon_admins.id в зависимости от role_in_salon.

Example:salon_role_id=15
curl -i -X GET \
  'https://felmee.com/api/salon/invite?role_in_salon=MASTER&salon_role_id=15' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Ссылка приглашения успешно получена

Bodyapplication/json
codeErrorstring or nullrequired

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

successbooleanrequired

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

messagestringrequired

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

error_codestring or null(ERROR_CODE)required

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

Enum:"invalid_body""unauthorized""not_found""conflict""object_modified_by_another_thread""action_too_late""too_many_request""code_is_gone""forbidden""user_blocked"
dataobject or null(GetSalonInviteLinkData)required

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

Response
{
  "success": true,
  "message": "Salon invite link created successfully",
  "codeError": null,
  "error_code": null,
  "data": {
    "invite_link": "https://felmee.com/api/auth/phone/login?invite_code=KRHoJt65qCvqi-y9B5P2IidpE2tw2vxY"
  }
}