> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Создать ссылку для входа

> Создаёт ограниченный по времени токен и URL входа в указанный аккаунт.

Создаёт ограниченный по времени токен и URL входа в указанный аккаунт.

Нужен Super key и одновременно scopes `auth` и `auth:login_token`. Сначала API создаёт токен; вход в браузере происходит только после открытия `login_url`. Уже вошедший посетитель сохраняет аккаунт, если не задан `force=1`. По умолчанию `remember=1`. Ссылка и токен дают возможность входа: не публикуйте их и проверяйте `expiry_date`.

## Доступ

Передавайте `XF-Api-Key` в заголовке каждого запроса. [Типы ключей и выбор пользователя](/guard-forum/authentication).

Требуемые scopes: `auth`, `auth:login_token`. Все перечисленные разрешения нужны одновременно.

Метод доступен только с Super key.

## Параметры

**XF-Api-Key** `string` *required*

Секретный API-ключ. В примерах ключ берётся из серверной переменной `$FORUM_API_KEY`.

Тело запроса: `application/x-www-form-urlencoded`. Вложенные значения передавайте в форме с квадратными скобками в имени поля.

**user\_id** `integer` *required*

ID пользователя, для которого создаётся ссылка входа.

**limit\_ip** `string`

Ограничить использование создаваемого токена указанным IP клиента.

**return\_url** `string`

Адрес перехода после входа. Без него пользователь попадёт на главную страницу форума.

**force** `boolean`

При `1` ссылка заменяет вход в другой аккаунт. По умолчанию `0`: уже вошедший посетитель сохраняет свой аккаунт.

**remember** `boolean`

Сохранять вход через cookie «запомнить меня». По умолчанию `1`.

## Ответ

HTTP `200`, JSON. [Схемы объектов и условные поля](/guard-forum/models).

**login\_token** `string`

Секретный токен автоматического входа.

**login\_url** `string`

Секретная ссылка, которую нужно открыть в браузере для входа.

**expiry\_date** `integer`

Срок действия токена в Unix time. После него ссылка входа недействительна.

Ошибки возвращаются в общей структуре `errors`. Обрабатывайте поле `code`; текст `message` может меняться или переводиться. [Формат ошибок](/guard-forum/requests-and-errors).

```bash cURL theme={null}
curl --request POST 'https://forum.arzguard.com/api/auth/login-token' \
  --header "XF-Api-Key: $FORUM_API_KEY" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'user_id=42'
```

```json 200 · условный пример theme={null}
{
  "login_token": "EXAMPLE_LOGIN_TOKEN",
  "login_url": "https://forum.arzguard.com/login/api-token?token=EXAMPLE_LOGIN_TOKEN",
  "expiry_date": 1700000300
}
```

Примеры сокращены и содержат только условные значения. Состав полей объектов зависит от прав, контекста и установленных дополнений.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.