Сервис поддерживает четыре типа запросов:

1. Проверка истории регистрации в Госавтоинспекции
2. Проверка на участие в дорожно-транспортных происшествиях
3. Проверка нахождения в розыске
4. Проверка наличия ограничений

Все запросы требуют указания ключа доступа (key).

1. Проверка истории регистрации в Госавтоинспекции

https://parser-api.com/parser/gibdd_api/history

Параметры:

• vin — VIN номер автомобиля

Пример запроса по проверке истории регистрации:

https://parser-api.com/parser/gibdd_api/history?key=ВАШ_КЛЮЧ_ДОСТУПА&vin=Х9Н77А3ВJС0000513

Пример ответа:

{
  "success": 1, // флаг успешного выполнения запроса
  "history": { // Информация по истории регистрации
    "engineVolume": "3990.0", // Рабочий объем
    "color": "КРАСНЫЙ", // Цвет 
    "bodyNumber": "Х9Н77А3ВJС0000513", // Номер кузова
    "year": "2012", // Год выпуска
    "engineNumber": "НС511259ХА01", // Номер двигателя
    "vin": "Х9Н77А3ВJС0000513", // VIN
    "model": "АФ 77А3ВJ", // Модель
    "category": "С", // Категория
    "type": "Грузовые автомобили фургоны", // Тип
    "powerHp": "132", // Мощность, л.с.
    "powerKwt": "97.09", // Мощность, кВт
    "vehiclePassport": { //
      "number": "62НО796550", // номер ПТС
      "issue": "ООО \"ФОТОН МОТОР\"" // ПТС выпущен
    },
    "ownershipPeriods": [
      { //
        "personType": "Физическое лицо", // Тип лица
        "from": "2013-09-04T00:00:00.000+04:00", // Дата постановки на учет
        "to": "2014-07-03T00:00:00.000+04:00", // Дата снятия с учета
        "lastOperation": "Прекращение регистрации ",
        "lastOperationId": "07"
      }, //
      { //
        "personType": "Физическое лицо",
        "from": "2014-07-03T00:00:00.000+04:00",
        "to": null,
        "lastOperation": "Прекращение регистрации ",
        "lastOperationId": "07"
      }
    ]
  }
}

2. Проверка на участие в дорожно-транспортных происшествиях

https://parser-api.com/parser/gibdd_api/accident

Параметры:

• vin — VIN номер автомобиля
• bodyNumber — номер кузова
• chassisNumber — номер шасси

Пример запроса по проверке на участие в дорожно-транспортных происшествиях:

https://parser-api.com/parser/gibdd_api/accident?key=ВАШ_КЛЮЧ_ДОСТУПА&vin=JN1FANF15U0109775

Пример ответа:

{
  "success": 1, // флаг успешного выполнения запроса
  "accidents": [ // ДТП
    { //
      "model": "Nexia", // Модель
      "mark": "DAEWOO", // Марка
      "vehicleYear": "2012", // Год выпуска
      "accidentType": "Столкновение", // Тип ДТП
      "regionName": "Тульская область", // Регион, в котором зарегистрировано ДТП
      "vehicleDamageState": "Повреждено", // Состояние
      "accidentDatetime": "22.09.2016 07:50", // Дата и время ДТП
      "damageSvg": "http://parser-api.com/parser/gibdd_api/?key=ВАШ_КЛЮЧ&damage_svg=01,08", // SVG схема повреждений для встраивания в HTML разметку
      "damageDescription": [ //Описание повреждений
        "ПЕРЕДНИЙ БАМПЕР",
        "КАПОТ",
        "РЕШЕТКА РАДИАТОРА"
      ],
      "vehicleSort": "1", // номер ТС в ДТП
      "vehicleAmount": "2" // всего ТС в ДТП
      "accidentPlace": "Краснодарский край, Краснодар, Карасунский", //место ДТП
      "ownerOkopf": "ФИЗИЧЕСКИЕ ЛИЦА" // категория владельца
    }
  ]
}

3. Проверка нахождения в розыске

https://parser-api.com/parser/gibdd_api/wanted

Параметры:

• vin — VIN номер автомобиля
• bodyNumber — номер кузова
• chassisNumber — номер шасси

Пример запроса по проверке на нахождение в розыске:

https://parser-api.com/parser/gibdd_api/wanted?key=ВАШ_КЛЮЧ_ДОСТУПА&vin=JN1FANF15U0109775

Пример ответа:

{
  "success": 1, // флаг успешного выполнения запроса
  "searches": [ // Розыск
    {
      "region": "город Санкт-Петербург", //Регион розыска
      "model": "ВМW520D", // Модель
      "model_year": "2008", // Год выпуска
      "search_date": "29.10.2016" // Дата начала розыска
    }
  ]
}

4. Проверка наличия ограничений

https://parser-api.com/parser/gibdd_api/restrict

Параметры:

• vin — VIN номер автомобиля
• bodyNumber — номер кузова
• chassisNumber — номер шасси

Пример запроса по проверке наличия ограничений:

https://parser-api.com/parser/gibdd_api/restrict?key=ВАШ_КЛЮЧ_ДОСТУПА&vin=JN1FANF15U0109775

Пример ответа:

{
  "success": 1, // флаг успешного выполнения запроса
  "restrictions": [
    { //
      "model": "АФ 77А3ВJ", // Модель
      "model_year": "2012", // Год выпуска
      "restriction_date": "23.10.2015", // Дата наложения ограничения
      "region": "Белгородская область", // Регион
      "restriction_name": "Запрет на регистрационные действия", // Тип ограничения
      "organization_name": "Судебный пристав",  // Кто наложил ограничение
      "reasons": "Документ: 76981200/2327 от 20.03.2019, Иванов Иван Иванович, СПИ: 3270100000152, ИП: 3049/16/23027-ИП от 28.01.2016",
      "phone": "+7(111)552-11-11"
    }
  ]
}

Интерпретация ответа и обработка ошибок

Общие рекомендации:

• Если поле success заполнено и success = 1 — перед вами успешный ответ, с которым можно работать. Только такие запросы учитываются в статистике и расходуют оплаченный лимит.
• Иначе, если поле error заполнено — запрос требует вашего внимания. Текст ошибки рекомендуется сохранить или отправить для дальнейшего анализа.
• Иначе, если поле error не заполнено — это ошибка, связанная со стабильностью источника. В таком случае мы рекомендуем игнорировать ответ и повторить запрос.

В данном разделе описаны возможные коды ответов сервиса и их значения. Каждый код ответа сопровождается пояснением и примером JSON-ответа.

1. Код ответа - 200

Выдается сервисом в случае успешной валидации и успешной обработки запроса источником. Всегда сопровождается полем success = 1 в корне ответа. Именно такие и только такие запросы можно запускать в дальнейшую обработку. Примеры ответов см. выше.

2. Код ответа - 403

Выдается сервисом в случае невозможности обработки запроса из-за ограничения доступа: закончилась подписка, превышен лимит и так далее. Причины ошибок отражены в поле error ответа. Ниже приведен список возможных ошибок с их описанием и кодами:

• Invalid access key error_code = 40301 Указанный ключ доступа недействителен или отсутствует.
• The subscription period has expired error_code = 40302 Доступ к сервису истек, требуется продление.
• Invalid IP error_code = 40303 Запрос выполнен с IP-адреса, который не разрешён для доступа.
• Day limit of requests exceeded error_code = 40304 Достигнут оплаченный лимит запросов на день.
• Month limit of requests exceeded error_code = 40305 Достигнут оплаченный лимит запросов на месяц.

Пример ответа:

{
  "error": "Invalid access key",
  "error_code": 40301
}

3. Код ответа - 400

Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле error_code всегда равно 40001, подробности доступны в поле error.

Пример ответа:

{
  "error": "Empty vin",
  "error_code": 40001
}

4. Код ответа - 523

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