Метод аутентификации пользователя API

Для работы с запросами HTTP API пользователь должен пройти аутентификацию. При аутентификации автоматически определяется уникальный идентификатор, который является токеном пользователя.

Для определения токена пользователя вручную выполните запрос с помощью API-метода auth:

curl -v '<IP-адрес или DNS-имя сервера>/api/v1/auth/jwt/obtain/' -d "environment=<название среды>&password=<пароль пользователя API>&username=<имя пользователя API>&project=<название проекта>&device_id=<идентификатор устройства>"

Пример ответа с содержанием токена пользователя:

{

"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwcm9qZWN0X2lkIjoxLCJlbnZpcm9ubWVudCI6Im"

}

Пример ответа с ошибкой аутентификации:

{

    "code": 401,

    "description": "Unauthorized"

}

Пример ответа с указанием неверных параметров:

400 Bad Request

Особенности аутентификации

Остальные методы API не используют учетную запись пользователя, если в запросе есть файлы cookie с валидным токеном. При запросе без валидного токена возвращается ответ с ошибкой аутентификации.

Если в запросе задан параметр «device-Id», то при успешной аутентификации в базе данных будет создано устройство и привязано к текущему пользователю. Устройство создается в том случае, если оно не было создано ранее.

См. также:

API сервера | Метод получения описания ресурсов