POST /auth/login

Аутентифицирует пользователя в личном кабинете и создает пользовательскую сессию.

Формат запроса

POST https://apiauto.ru/1.0/auth/login

Формат тела запроса

{
  "login": "{string}",
  "password": "{string}"
}

login*

Логин пользователя: номер телефона в формате 79051112233 или адрес электронной почты.

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

Объект session. Сессия пользователя.


id

Идентификатор сессии.


user_id

Идентификатор пользователя.


creation_timestamp

Время создания сессии.


expire_timestamp

Время окончания жизни сессии.


ttl_sec

Время жизни сессии в миллисекундах.


user

Объект 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
PASSWORD_EXPIRED

Не удается аутентифицироваться.

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"
}

* Обязательный параметр

Следующая