Поиск информации о транспортном средстве

Для получения информации о транспортном средстве используйте следующий запрос:

https://parser-api.com/parser/gibdd_additional_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&vin=VIN_НОМЕР

или

https://parser-api.com/parser/gibdd_additional_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&bodyNumber=НОМЕР_КУЗОВА

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

• key — ключ доступа к сервису (обязательный).
• vin — VIN номер транспортного средства (опциональный, требуется vin или bodyNumber).
• bodyNumber — номер кузова транспортного средства (опциональный, требуется vin или bodyNumber).

Пример запроса по VIN номеру:

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

Пример запроса по номеру кузова:

https://parser-api.com/parser/gibdd_additional_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&bodyNumber=ZNE100256148

Пример ответа на запрос:

Ответ на запрос возвращается в формате JSON. Пример ответа:

{
  "success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
  "record": {
    "vin": "XTA21202010323607", // VIN номер
    "bodyNumber": null, // Номер кузова
    "regNumber": "А123ВВ77", // Государственный регистрационный номер
    "sts": { // Свидетельство о регистрации ТС (СТС)
      "num": "7745362189", // Номер СТС
      "date": "2020-06-19" // Дата выдачи СТС
    },
    "pts": { // Паспорт транспортного средства (ПТС)
      "num": "77МХ123456", // Номер ПТС
      "date": "2008-05-19" // Дата выдачи ПТС
    },
    "model": "VOLVO FH12 420 4Х2", // Марка и модель транспортного средства
    "engineVolume": "1499", // Объем двигателя (куб. см)
    "color": "синий", // Цвет транспортного средства
    "powerHp": "78.2", // Мощность двигателя (л.с.)
    "powerKwt": "57.5", // Мощность двигателя (кВт)
    "year": "2003", // Год выпуска
    "maxWeight": "17990", // Максимальная масса (кг)
    "weightWithoutLoading": "7120", // Снаряженная масса (кг)
    "category": "C", // Категория транспортного средства
    "lastRegAction": "В связи с получением ГРЗ", // Последнее регистрационное действие
    "ownershipPeriods": [ // Периоды владения/регистрации
      {
        "from": "2014-12-20", // Дата начала периода регистрации
        "to": "2019-06-19" // Дата окончания периода регистрации
      },
      {
        "from": "2019-06-19", // Дата начала периода регистрации
        "to": null // Дата окончания периода регистрации (null - текущий владелец)
      }
    ]
  }
}

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

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

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

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

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

• Поле success = 1 - удалось получить информацию от источника. Такие и только такие запросы можно запускать в дальнейшую обработку.
• Поле success = 0 - не удалось получить информацию от источника. Запрос не будет учтен в статистике. Необходимо повторить запрос.

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": "vin or bodyNumber is required",
  "error_code": 40001
}