API
Информация о пользователе
Получение актуальных данных пользователя через UserInfo endpoint Флида ID.
Шаг 1. Сформируйте запрос
UserInfo endpoint возвращает данные авторизованного пользователя, доступные вашему проекту в рамках выданных областей доступа.
Передайте действующий access_token в заголовке Authorization по схеме Bearer:
GET /oidc/userinfo HTTP/1.1
Host: api.flida.ru
Authorization: Bearer jb_R5GUySe03A429pTEGh5AmovonbN0k2ArE-8r2k04Шаг 2. Обработайте ответ
Успешный ответ
Сервер вернет 200 OK и JSON. Набор полей зависит от областей доступа, запрошенных при авторизации и подтвержденных пользователем.
{
"sub": "v1.ffd02a9186905c46c21a2f671ec665470c9533660658bcf4e610369a57155658",
"given_name": "Александр",
"family_name": "Пушкин",
"middle_name": "Сергеевич",
"nickname": "Пушкин А. С.",
"date_of_birth": "2001-01-02",
"sex": "male",
"phone_number": "+79107777777",
"phone_number_verified": true,
"email": "test@test.ru",
"email_verified": true
}| Поле | Описание |
|---|---|
sub | Попарный идентификатор пользователя в организации, которой принадлежит проект. Два проекта одной организации получают одинаковый sub для одного пользователя. |
given_name | Область доступа name. Имя. |
family_name | Область доступа name. Фамилия. |
middle_name | Область доступа name. Отчество; может отсутствовать. |
nickname | Область доступа nickname. Отображаемое имя. |
date_of_birth | Область доступа date_of_birth. Дата рождения в формате YYYY-MM-DD. |
sex | Область доступа sex. Значение female или male. |
phone_number | Область доступа phone. Номер телефона. |
phone_number_verified | Область доступа phone. Признак подтверждения номера телефона. |
email | Область доступа email. Адрес электронной почты. |
email_verified | Область доступа email. Признак подтверждения адреса электронной почты. |
Не рассчитывайте на наличие необязательных полей: пользовательские данные могут отсутствовать или не входить в предоставленные области доступа.
Ошибки UserInfo
При ошибке сервер возвращает JSON. Для 401 Unauthorized также передается заголовок WWW-Authenticate: Bearer с деталями.
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer error="invalid_token", error_description="invalid access token"
Content-Type: application/json
{
"error": "invalid_token",
"error_description": "invalid access token"
}| HTTP-статус | Ошибка | Что означает | Что делать проекту |
|---|---|---|---|
401 | invalid_token | Токен отсутствует, имеет неверный формат, истек или не найден. Такой же ответ возвращается, если учетная запись пользователя или проект больше недоступны. | Попробовать обновить токены. Если обновление не удалось, запросить повторный вход пользователя. |
500 | server_error | Флида ID не смог получить данные пользователя из-за внутренней ошибки. | Повторить запрос позже. |
© 2026 ООО «Флида»