POST /auth/login
Аутентифицирует пользователя в личном кабинете и создает пользовательскую сессию.
Формат запроса
POST https://apiauto.ru/1.0/auth/login
Формат тела запроса
{
"login": "{string}",
"password": "{string}"
}
login* |
Логин пользователя: номер телефона в формате |
password* |
Пароль. |
Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.
Формат ответа
{
"session": {
"id": "{string}",
"user_id": "{string}",
"creation_timestamp": "{string}",
"expire_timestamp": "{string}",
"ttl_sec": {integer}
},
"user": {
"id": "{string}",
"profile": {
"autoru": {
"alias": "{string}",
"userpic": {
"name": "{string}",
"sizes": {"{string}": "{string}"}
},
"client_id": "{string}",
"birthday": "{string}",
"about": "{string}",
"driving_year": {integer},
"full_name": "{string}",
"geo_id": {integer}
}
},
"registration_date": "{string}",
"active": {boolean},
"emails": [
{
"email": "{string}",
"confirmed": {boolean},
"added": "{string}"
}
],
"phones": [
{
"phone": "{string}",
"added": "{string}"
}
],
"social_profiles": [
{
"provider": "{string}",
"social_user_id": "{string}",
"added": "{string}",
"nickname": "{string}",
"first_name": "{string}",
"last_name": "{string}"
}
],
"registration_ip": "{string}"
},
"status": "{string}"
}
session |
Объект |
-
id
Идентификатор сессии.
user_id
Идентификатор пользователя.
creation_timestamp
Время создания сессии.
expire_timestamp
Время окончания жизни сессии.
ttl_sec
Время жизни сессии в миллисекундах.
user |
Объект |
-
id
Идентификатор пользователя.
profile
Объект
user_profile
. Профиль пользователя.
-
autoru
Профиль пользователя на Авто.ру.
-
alias
Ник (имя пользователя, под которым он зарегистрирован).
userpic
Аватар пользователя.
-
name
Идентификатор фотографии.
sizes
Объект с возможными размерами фотографии. Пример:
"120x90":"//images.md../943h4345/68..cd..ceeb..regbbdf43/120x90"
, где первый параметр — размер картинки, второй — URL-адрес картинки.
client_id
Идентификатор карточки клиента.
birthday
Дата рождения пользователя.
about
Информация в разделе «О себе».
driving_year
Стаж вождения в годах.
full_name
ФИО полностью.
geo_id
Идентификатор населенного пункта пользователя. Справочник регионов можно скачать по ссылке.
-
-
registration_date
Дата регистрации пользователя в формате
YYYY-MM-DD
.
active
Признак того, что пользователь завершил регистрацию.
emails
Массив объектов
user_email
. Подтвержденные адреса электронной почты.
-
email
Электронный адрес пользователя.
confirmed
Признак подтверждения электронного адреса.
added
Дата добавления электронного адреса в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
.
phones
Массив объектов
user_phone
. Подтвержденные телефоны.
-
phone
Номер телефона пользователя.
added
Дата добавления электронного адреса в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
.
social_profiles
Массив объектов
user_social_profile
. Привязанные социальные профили.
-
provider
Провайдер.
Допустимые значения:
VK
FACEBOOK
TWITTER
OK
YANDEX
GOOGLE
MAILRU
social_user_id
Идентификатор пользователя у провайдера.
added
Дата добавления электронного адреса в формате ISO 8601 со смещением относительно UTC. Например,
2017-07-08T11:29:16+03:00
.
nickname
Ник (имя пользователя, под которым он зарегистрирован).
first_name
Имя пользователя.
last_name
Фамилия пользователя.
registration_ip
IP регистрации пользователя.
-
status |
Статус ответа. |
Коды ответа
Код |
Причина |
Описание |
200 |
OK |
Успешный запрос. |
401 |
AUTH_ERROR |
Неверный логин / пароль. |
400 |
BAD_REQUEST |
Синтаксическая ошибка в запросе. |
403 |
CODE_AUTH_REQUIRED |
Не удается аутентифицироваться. |
500 |
INTERNAL SERVER ERROR |
Внутренняя ошибка сервера. |
Пример
Запрос:
curl -i -X POST 'https://apiauto.ru/1.0/auth/login' -H 'x-authorization: 2dtrer432...' -d '{"login":"ivan-ivanov@auto.ru","password":"autoru"}' -H 'Accept: application/json' -H 'Content-Type: application/json'
Ответ:
HTTP/1.1 200 OK Server: nginx Date: Mon, 28 May 2018 14:33:39 GMT Content-Type: application/json Content-Length: 1651 Connection: keep-alive { "session": { "id": "11112233|152...019.777..0.oWEL...JwyqRHw...", "user_id": "11112233", "device_uid": "76ebe2f87d5850c5c12...", "creation_timestamp": "2018-05-28T14:33:39.697Z", "expire_timestamp": "2018-08-26T14:33:39.697Z", "ttl_sec": 7776000 }, "user": { "id": "11112233", "profile": { "autoru": { "alias": "IvanIvanov", "userpic": { "name": "48059-9f4f43d85...", "sizes": { "24x24": "//images.mds...a.ru/get-autoru-users/48059/9f4f43d85.../24x24", "100x100": "//images.mds...a.ru/get-autoru-users/48059/9f4f43d85...100x100", "430x600": "//images.mds...a.ru/get-autoru-users/48059/9f4f43d85.../430x600", "48x48": "//images.mds...a.ru/get-autoru-users/48059/9f4f43d85.../48x48", "200x200": "//images.mds...a.ru/get-autoru-users/48059/9f4f43d85.../200x200" } }, "client_id": "11111", "birthday": "1984-04-01", "show_card": true, "show_mail": true, "allow_messages": true, "driving_year": 2009, "country_id": "1", "region_id": "87", "city_id": "1123", "geo_id": "213" } }, "registration_date": "2014-09-05", "active": true, "emails": [ { "email": "ivan-ivanov@auto.ru", "confirmed": true } ], "phones": [ { "phone": "70009998877", "added": "2015-03-24T12:03:13Z" }, { "phone": "79991113177", "added": "2017-09-15T07:00:53Z" } ], "social_profiles": [ { "provider": "YANDEX", "social_user_id": "430605923", "added": "2017-01-20T17:07:31Z", "nickname": "ivan-ivanov", "first_name": "Иван", "last_name": "Иванов" } ], "registration_ip": "77.110.106.138" }, "status": "SUCCESS" }
* Обязательный параметр