## Документация API api-assist.com ГИБДД проверка авто

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

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

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

---

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

```
https://service.api-assist.com/parser/gibdd_api/history
```

**Параметры:**

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

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

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

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

```json-toggle
{
  "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://service.api-assist.com/parser/gibdd_api/accident
```

**Параметры:**

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

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

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

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

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

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

```
https://service.api-assist.com/parser/gibdd_api/wanted
```

**Параметры:**

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

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

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

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

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

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

```
https://service.api-assist.com/parser/gibdd_api/restrict
```

**Параметры:**

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

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

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

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

```json-toggle
{
  "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", // Телефон
      "gid": "77#SP0004193780" // Ключ ФИС ГИБДД-М
    }
  ]
}
```

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

**Общие рекомендации:**
- Если поле `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`  
  Достигнут оплаченный лимит запросов на месяц.

**Пример ответа:**
```json
{
  "error": "Invalid access key",
  "error_code": 40301
}
```

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

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

**Пример ответа:**
```json
{
  "error": "Empty vin",
  "error_code": 40001
}
```