Tinkoff ID. Информация о пользователе
Методы принадлежат API Tinkoff ID и нужны для получения информации о физических лицах. Доступно только в партнёрском сценарии.
Получение учётных данных
Пользователь должен дать согласие на предоставление следующих данных: «Полное имя», «E-mail», «Номер телефона». Перечень scopes
у токена для получения учётных данных:
- profile;
- phone;
- email.
Входные параметры
- Заголовок
Authorization = Bearer \\{access_token}
. - Поля формы
application/x-www-form-urlencoded
: client_id
— ID клиента;client_secret
— пароль клиента.
Формат ответа
Ответ метода представлен в формате application/json
. Поля json-документа (зависит от scope, нефиксированный список):
sub
— идентификатор авторизированного пользователя;name
— фамилия, имя;gender
— пол;birthdate
— дата рождения в формате yyyy-mm-dd;family_name
— фамилия;given_name
— имя;middle_name
— отчество;phone_number
— телефон в формате + (международный идентификатор страны)(номер абонента);email
— почтовый адрес.
Пример запроса
POST https://id.tinkoff.ru/userinfo/userinfo
Пример ответа
"email": "tinkoff@mail.ru", "email_verified": false, "family_name": "Иванов", "birthdate": "2000-01-01", "sub": "923d4812-148c-45v4-a56b-eed15cdd2857", "name": "Иванов Олег", "gender": "male", "phone_number": "+79998887766", "phone_number_verified" : true, "middle_name": "Юрьевич", "given_name": "Олег"