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

### Получение штрафов

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

```
https://service.api-assist.com/parser/fines_api/fines?key=ВАШ_КЛЮЧ_ДОСТУПА&sts=5058794047
```

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

- **key** — ключ доступа к сервису (обязательный).
- **sts** — номер свидетельства о регистрации транспортного средства (СТС).
- **driverLicense** — номер водительского удостоверения (ВУ), 10 цифр (серия 4 + номер 6).
- **numPost** — номер постановления (УИН).

Должен быть передан **хотя бы один** из параметров `sts`, `driverLicense`, `numPost`.

> **Важно:** при поиске по `sts` или `driverLicense` доступны только **неоплаченные** постановления. Чтобы проверить статус оплаты конкретного постановления (поле `paid`), выполните поиск по `numPost`.

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

По СТС:
```
https://service.api-assist.com/parser/fines_api/fines?key=ВАШ_КЛЮЧ_ДОСТУПА&sts=5058794047
```

По водительскому удостоверению:
```
https://service.api-assist.com/parser/fines_api/fines?key=ВАШ_КЛЮЧ_ДОСТУПА&driverLicense=9937131611
```

По номеру постановления (УИН):
```
https://service.api-assist.com/parser/fines_api/fines?key=ВАШ_КЛЮЧ_ДОСТУПА&numPost=18810572260413020388
```

**Пример ответа (штрафы найдены):**

```json
{
  "success": 1, // флаг успешного выполнения запроса
  "fines": [
    {
      "enable_discount": false, // актуальна ли скидка при оплате
      "date_discount": null, // дата, до которой актуальна скидка
      "num_post": "0355431010126011401013248", // номер постановления
      "sum": 5000, // полная сумма штрафа, без скидки
      "division_name": "Администратор Московского парковочного пространства (ГКУ АМПП)", // наименование подразделения, вынесшего постановление
      "date_post": "2026-01-14", // дата вынесения постановления
      "paid": false // оплачен ли штраф
    },
    {
      "enable_discount": true,
      "date_discount": "2026-04-29 00:00:00",
      "num_post": "18810550260330143671",
      "sum": 750,
      "division_name": "УФК по Московской области (Управление Госавтоинспекции ГУ МВД России по Московской области)",
      "date_post": "2026-03-30",
      "paid": false
    }
  ]
}
```

**Пример ответа (штрафы не найдены):**

```json
{
  "success": 1
}
```

---

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

**Общие рекомендации:**
- Если поле `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`.

**Возможные ошибки валидации:**

- `At least one of sts, driverLicense or numPost is required` — не передан ни один из параметров поиска

**Пример ответа:**
```json
{
  "error": "At least one of sts, driverLicense or numPost is required",
  "error_code": 40001
}
```