Идентификаторы ТС

A.0001.IDN.BAS

Содержит связку идентификаторов ТС: VIN, ГРЗ, а также номер кузова и шасси, то есть является базовым для получения всей информации об автомобиле вне зависимости от того, по какому из этих идентификаторов осуществляется запрос.

Дополнительно блок отдаёт маскированные идентификаторы — на случай, если они будут показываться в пользовательских интерфейсах — для исключения случаев парсинга данных мошенниками.

Также блок содержит значение производственного идентификационного номера ТС, который может не совпадать с VIN самого ТС, и требуется для решения ряда задач. Производственный VIN доступен не для всех ТС, возможно его отсутствие или неточное значение.

Источники данных — официальная информация ГИБДД, открытые источники в интернете (доски объявлений и пр.).

Идентификаторы объекта: VIN, ГРЗ, СТС, номер кузова или номер шасси.

Иcпользуемые источники: base.

Время генерации отчёта:

  • 50-й перцентиль — 1 с;
  • 95-й перцентиль — 1 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип идентификатора ТС.
Возможные значения: VIN, GRZ, STS, BODY или CHASSIS
query string Обязательный Значение идентификатора ТС

Пример тела запроса

{
  "queryType": "VIN",
  "query": "EXAMPL0V1N1000000"
}

Структура отчёта

Данные отчёта находятся в объекте data[].content тела ответа.

Поле Тип Описание
identifiers.vehicle.vin string VIN
identifiers.vehicle.reg_num string ГРЗ
identifiers.vehicle.sts string Номер СТС
identifiers.vehicle.body string Номер кузова
identifiers.vehicle.chassis string Номер шасси
identifiers.manufacture.vin string Производственный VIN
identifiers_masked.vehicle.vin string Маскированный VIN: первые 4 символа и 1 последний
identifiers_masked.vehicle.reg_num string Маскированный ГРЗ: первые 2 символа и 2 последних
identifiers_masked.vehicle.sts string Маскированный номер СТС: первые 3 символа и 2 последних
identifiers_masked.vehicle.body string Маскированный номер кузова: первые 3 символа и 1 последний
identifiers_masked.vehicle.chassis string Маскированный номер шасси: первые 2 символа и 1 последний

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "A.0001.IDN.BAS_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "base",
            "state": "OK",
            "extended_state": "OK"
          }
        ]
      },
      "content": {
        "identifiers": {
          "vehicle": {
            "vin": "EXAMPL0V1N1000000",
            "reg_num": "А111АА00",
            "sts": "1010100000",
            "body": "EXPLBD-1000000",
            "chassis": "EXPLCHS100000"
          },
          "manufacture": {
            "vin": "EXAMPL0V1N1000002"
          }
        },
        "identifiers_masked": {
          "vehicle": {
            "vin": "EXAM************0",
            "reg_num": "А******00",
            "sts": "101*****00",
            "body": "EXP**********0",
            "chassis": "EX**********0"
          }
        }
      }
    }
  ]
}