## Документация API ОСАГО НСИС

### Поиск полисов ОСАГО по VIN номеру

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

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

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

### Поиск полисов ОСАГО по гос номеру
```
https://service.api-assist.com/parser/osago_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&regNumber=ГОС_НОМЕР
```

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

- **key** — ключ доступа к сервису (обязательный).
- **regNumber** — гос номер.

### Поиск полисов ОСАГО по номеру кузова

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

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

- **key** — ключ доступа к сервису (обязательный).
- **bodyNumber** — номер кузова.

### Поиск полисов ОСАГО по серии и номеру полиса

```
https://service.api-assist.com/parser/osago_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&series=СЕРИЯ_ПОЛИСА&number=НОМЕР_ПОЛИСА
```

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

- **key** — ключ доступа к сервису (обязательный).
- **series** — серия полиса.
- **number** — номер полиса.

### Формат ответа на запрос

```
{
  "success": 1, // флаг успешного выполнения запроса, 1/0. В случае сбоя в получении данных флаг = 0, запрос не учитывается, информацию нужно запросить позднее
  "policies": [ // полисы
    {
      "companyName": "Страховое публичное акционерное общество \"Ингосстрах\"",  // компания, выдавшая полис
      "policySerial": "ХХХ", // серия полиса
      "policyNumber": "0451703060", // номер полиса
      "vin": null, // VIN автомобиля
      "vin_mask": "Y4K8622Z3PB9*****", // маска VIN автомобиля
      "regNumber": null, // гос номер
      "regNumber_mask": "М2***А04", // маска гос номер
      "mark": "Geely", // марка
      "model": "Coolray", // модель
      "startDate": "2024-09-29", // дата начала периода страхования
      "endDate": "2025-09-28", // дата окончания периода страхования
      "status": "Действует" //статус
    }
  ]
}
```

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

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

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

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

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

#### 2. Код ответа - 523

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

**Пример ответа:**
```json
{
  "success": 0
}
```

#### 3. Код ответа - 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
}
```

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

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

**Пример ответа:**
```json
{
  "error": "Date field could be maximum a year from the current date",
  "error_code": 40001
}
```