User-Api-Token
User-Api-Token подходит для ручной проверки API и простых интеграций, где все запросы выполняются от имени одного пользователя.
Токен выпускает кадровик в интерфейсе HRlink под своей учётной записью. Каждый запрос с этим токеном выполняется с правами пользователя, который выпустил токен.
Свойства токена
| Свойство | Значение |
|---|---|
| Заголовок | User-Api-Token |
| Срок жизни | 1 год с момента выпуска |
| Работа от имени другого пользователя | Нет |
| Проверка состояния | Информация о текущем API-токене |
Продлить токен программно нельзя. Когда срок действия закончится, выпустите новый токен в интерфейсе HRlink.
Пример запроса
- curl
- PowerShell
- HTTP
curl -X GET "https://{tenantHost}/api/v2/currentUser" \
-H "Accept: application/json" \
-H "User-Api-Token: {ваш_токен}"
Invoke-RestMethod -Uri "https://{tenantHost}/api/v2/currentUser" `
-Method GET `
-Headers @{
"Accept" = "application/json"
"User-Api-Token" = "{ваш_токен}"
}
GET /api/v2/currentUser HTTP/1.1
Host: {tenantHost}
Accept: application/json
User-Api-Token: {ваш_токен}
Ограничения
- Все запросы выполняются от имени пользователя, который выпустил токен.
- Токен нельзя использовать для работы от имени другого пользователя.
- Токен перестаёт работать, если пользователь уволен, заблокирован, сбросил пароль или срок действия токена истёк.
Если токен перестал работать, см. ошибки аутентификации.