## Документация API api-assist.com проверка водительского удостоверения

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

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

---

### Получение информации о водительском удостоверении

```
https://service.api-assist.com/parser/driver_api/
```

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

- **num** — серия и номер водительского удостоверения (без пробелов)
- **date** — дата выдачи водительского удостоверения (формат: DD.MM.YYYY)

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

```
https://service.api-assist.com/parser/driver_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&num=5034401752&date=31.10.2017
```

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

```json
{
  "success": 1, // флаг успешного выполнения запроса
  "document": { // информация о найденном водительском удостоверении
    "dob": "1979-11-11", // дата рождения владельца
    "categories": "В, В1, М", // открытые категории
    "date_from": "2017-10-31", // дата начала действия удостоверения
    "date_to": "2027-10-31", // дата окончания действия удостоверения
    "comment": "Срок действия водительского удостоверения продлен в соответствии с постановлением Правительства Российской Федерации от 09.04.2022 № 626 на 3 года.", // комментарий (при наличии)
    "status": "Действует" // статус удостоверения ("Действует" или "Недействителен")
  },
  "decision": { // информация о лишении права управления ТС (при наличии)
    "bplace": "г. Москва", // место вынесения постановления
    "date": "2020-05-15", // дата вынесения постановления о лишении
    "period": "18", // период лишения (в месяцах)
    "state": "Постановление о лишении права управления ТС вступило в законную силу" // текущее состояние лишения
  },
  ]
}
```

**Возможные значения поля `state` (состояние постановления):**

- `Вынесено постановление о лишении права управления ТС`
- `Постановление о лишении права управления ТС вступило в законную силу`
- `Исчисление срока лишения права управления ТС прервано`
- `Поступление информации об уплате штрафа`
- `Поступление информации об уплате штрафа (от банка)`
- `Начато исчисление срока лишения права управления`
- `Окончено исчисление срока лишения права управления (возвращено ВУ)`
- `Проведение проверки знаний ПДД`

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

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

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

- `Empty num` — не указан обязательный параметр `num`
- `Empty date` — не указан обязательный параметр `date`

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