https://pastein.ru/t/iqA
Загрузка данных
Продакшн-доступ к Parser API
Тариф: позволяет выполнять до 500 запросов в день и до 15000 в месяц
Мониторинг лимита: тут
Тестовый доступ к Parser API
Parser API предоставляет тестовый доступ, который позволяет выполнить до 200 запросов в месяц для проверки корректности интеграции и оценки возможностей сервиса
Общая информация
Доступ предоставляется один раз, без возможности продления.
Лимит: 200 запросов на месяц
После завершения тестирования необходимо перейти на оплачиваемый тариф
Все запросы выполняются по протоколу HTTPS (порт 443)
Аутентификация осуществляется с помощью API-ключа, передаваемого через параметр через query-параметр «key» в URL
Базовый адрес API
https://parser-api.com
Наш тестовый ключ
key=2e5a00b1c7aa2f94434e1a0bbb81c9a8
Примеры тестовых запросов
https://parser-api.com/parser/fedresurs_api/?type=TYPE_SEARCH_FIZ®ionID=-1&lastName=Коновалов&firstName=Александр&patronymic=Николаевич&key=2e5a00b1c7aa2f94434e1a0bbb81c9a8
https://parser-api.com/parser/mvd_wanted_api/?key=2e5a00b1c7aa2f94434e1a0bbb81c9a8&firstName=Фахрудин&lastName=Махмудов&dob=1965-12-13
Дополнительно
Мониторинг лимита и статистики (отслеживаем сколько запросов у нас осталось)
Телеграм-бот для уведомлений (предоставляет только функции связанные с оплатой сервисов: уведомления об окончании доступа к сервису и достижении лимитов)
Для безопасности parser-API рекомендует ограничить список IP-адресов, с которых осуществляется доступ (список можно направить на support@parser-api.com)
Эндпоинты, используемые для интеграции с сервисом
Эндпоинты для проверки автомобиля на этапе мониторинга
Для всех проверок автомобиля (кроме проверки штрафов) используются только эти два query-параметра:
key
vin — VIN номер автомобиля
1. Проверка наличия ограничений
Метод: GET
Эндпоинт: parser/gibdd_api/restrict
Логика обработки запроса:
Если получены данные о нахождении автомобиля в розыске — система должна перевести заявку в статус «Отклонена по стоп-факторам». При этом в заявке должны быть зафиксированы поля:
Дата наложения ограничения
Вид ограничения
Если информация о нахождении в розыске отсутствует — в соответствующем поле заявки указывается «Ограничения отсутствуют»
Если проверка не дала результата или вернулась ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"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": 1,
"restrictions": []
}
2. Проверка нахождения автомобиля в розыске
Метод: GET
Эндпоинт: parser/gibdd_api/wanted
Логика обработки запроса:
Если получены данные о нахождении автомобиля в розыске — система должна перевести заявку в статус «Отклонена по стоп-факторам». При этом в заявке должны быть зафиксированы поля:
Регион розыска
Дата начала розыска
Если информация о нахождении в розыске отсутствует — в соответствующем поле заявки указывается «Автомобиль не находится в розыске»
Если проверка не дала результата или вернулась ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1,
"searches": [
{
"region": "город Санкт-Петербург",
"model": "ВМW520D",
"model_year": "2008",
"search_date": "29.10.2016"
}
]
}
{
"success": 1,
"searches": [
{
"region": "город Санкт-Петербург",
"model": "ВМW520D",
"model_year": "2008",
"search_date": "29.10.2016"
},
{
"region": "Ленинградская область",
"model": "ВМW520D",
"model_year": "2008",
"search_date": "15.03.2017"
}
]
}
{
"success": 1,
"searches": []
}
3. Проверка ЕПТС и статуса утилизации автомобиля
Метод: GET
Эндпоинт: parser/elpts_api
Логика обработки запроса:
По результатам запроса в заявке в соответствующих полях отображаются следующие данные:
Существование ЕПТС (да/нет)
Статус ЕПТС (действующий / недействующий)
Страна выдачи
Сведения об уплате утилизационного сбора (уплачен/ не уплачен)
Наличие ограничений (обременений)
Наличие таможенных ограничений
Сведения о последнем регистрационном действии (дата и тип действия)
Если данные недоступны или произошла ошибка, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1,
"found": 1,
"status": "действующий",
"records": [
{
"country": "Российская Федерация",
"type": "Электронный паспорт транспортного средства",
"displosal_fee": "РФ уплачен",
"restrictions_status": "отсутствуют",
"customs_restrictions_status": "отсутствуют",
"last_reg_action": "РФ - Постановка на регистрационный учет (23.11.2020)"
}
]
}
{
"success": 1,
"found": 0,
"status": null,
"records": []
}
4. Проверка истории регистрации
Метод: GET
Эндпоинт: parser/gibdd_api/history
Логика обработки запроса:
По результатам запроса в заявке в соответствующих полях отображаются следующие данные по каждому факту регистрации:
Модель
Год выпуска
Цвет
VIN
Номер кузова
Номер двигателя
Рабочий объём
Категория
Тип ТС
Мощность
Номер ПТС (необходимо отобразить данные, которые уже имеются в системе и которые вернулись в ответе для возможности сравнения верификатором)
История владения:
Тип владельца
Дата постановки на учёт
Дата снятия с учёта
Последняя операция
Код операции
Если данные недоступны или произошла ошибка, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1,
"history": {
"engineVolume": "3990.0",
"color": "КРАСНЫЙ",
"bodyNumber": "Х9Н77А3ВJС0000513",
"year": "2012",
"engineNumber": "НС511259ХА01",
"vin": "Х9Н77А3ВJС0000513",
"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"
}
]
}
}
{
"success": 1,
"history": {}
}
5. Проверка пробега автомобиля
Метод: GET
Эндпоинт: parser/eaisto_mileage_api
Логика обработки запроса:
По результатам запроса в заявке в соответствующих полях отображаются следующие данные о пробеге:
Диагностическая карта:
Номер карты
Дата начала действия
Дата окончания действия
VIN автомобиля
История пробега:
Дата
Пробег
Если данные недоступны или произошла ошибка, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"kbm_done": 1, // флаг успешной загрузки актуальной диагностической карты
"mileages_done": 1, // флаг успешной загрузки коллекции пробегов
"diagnose_cards": [ // актуальная диагностическая карта
{
"number": "201610101449162544920", // номер карты
"startDate": "10.10.2016", // дата начала действия карты
"endDate": "10.10.2017", // дата окончания действия карты
"vin": "WBANX31040C174862", // VIN автомобиля
"mileage": "130811" // пробег на момент прохождения техосмотра
}
],
"mileages": [ // коллекция пробегов по архивным картам
{
"date": "10.10.2016",
"mileage": 130811
},
{
"date": "19.09.2015",
"mileage": "102758"
}
]
}
{
"kbm_done": 0, // флаг, что актуальная диагностическая карта не найдена
"mileages_done": 0, // флаг, что данные о пробегах отсутствуют
"diagnose_cards": [], // пустой массив — нет актуальных карт
"mileages": [] // пустой массив — нет информации о пробеге
}
6. Проверка использования автомобиля в такси
Метод: GET
Эндпоинт: parser/taxi_api
Логика обработки запроса:
Если получены данные о разрешении на работу такси — в соответствующих полях заявки отображаются:
Дата начала действия разрешения
Дата окончания действия разрешения
Если автомобиль не числится в такси — в соответствующем поле заявки указывается «Автомобиль не зарегистрирован как такси»
Если данные недоступны или произошла ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"done": 1,
"vin": "XW8DA11Z1DK236754",
"regNumber": null,
"records": [
{
"vin": "XW8DA11Z1DK236754",
"regionName": "Краснодарский край",
"regNumber": "В311КА123",
"permitNumber": "13250",
"carLabel": "Skoda Octavia",
"year": "2012",
"color": "белый",
"dateFrom": "2014-05-13",
"dateTo": null,
"dateFgisAdded": "2023-09-02",
"isLiftingDevice": 0,
"isActual": 1,
"source": "fgis_taxi",
"carriers": [
{
"type": "ЮЛ",
"permitNumber": "000347-2",
"dateFrom": "2023-09-01",
"name": "ООО \"М Авто\"",
"ogrn": "1177746864690",
"inn": "7724417458",
"isActual": 1,
"dateAdded": "2023-09-03",
"dateRemoved": "2024-07-10"
}
]
}
]
}
{
"done": 1,
"vin": "XW8DA11Z1DK236754",
"regNumber": null,
"records": []
}
7. Проверка штрафов ГИБДД
Метод: GET
Эндпоинт: parser/fines_api
Параметры запроса:
key
regNumber
sts
Логика обработки запроса:
Если получены данные о штрафах ГИБДД — в соответствующих полях заявки по каждому штрафу отображаются:
Дата и время нарушения
Сумма штрафа
Если информация о штрафах отсутствует — в соответствующем поле заявки указывается «Штрафы ГИБДД отсутствуют»
Если данные недоступны или произошла ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"fines_done": true,
"message": null,
"fines": [
{
"enable_discount": true,
"date_discount": "2018-03-16 23:59:59",
"date_decision": "2018-02-24 17:00:00",
"koap_code": "12.9ч.2",
"koap_text": "ПРЕВЫШЕНИЕ УСТАНОВЛЕННОЙ СКОРОСТИ ДВИЖЕНИЯ ТРАНСПОРТНОГО СРЕДСТВА НА ВЕЛИЧИНУ БОЛЕЕ 20, НО НЕ БОЛЕЕ 40 КМ/Ч",
"num_post": "18810177180224390760",
"kbk": "18811630020016000140",
"sum": "500",
"division_name": "Управление ГИБДД ГУ МВД России по г. Москве",
"division_address": "г. Москва, ул. Садовая-Самотечная, д. 1",
"division_id": 1145000,
"date_post": "2018-02-24",
"date_ssp": null,
"photo_available": true,
"photo_token": "1c11d015f1981551371781b01471a618d15f14d1ec1f013a"
}
]
}
{
"fines_done": true,
"message": "Не найдено ТС с таким сочетанием СТС и ГРЗ",
"fines": []
}
8. Проверка участия автомобиля в ДТП
Метод: GET
Эндпоинт: parser/gibdd_api/accident
Логика обработки запроса:
Если получены данные об участие автомобиля в ДТП — в соответствующих полях заявки по каждому ДТП отображаются:
Марка и модель автомобиля (необходимо отобразить данные, которые уже имеются в системе и которые вернулись в ответе для возможности сравнения верификатором)
Тип ДТП
Регион происшествия
Место ДТП
Дата и время ДТП
Состояние автомобиля после ДТП
Описание повреждений
Схема повреждений
Номер ТС в ДТП
Количество ТС в ДТП
Если информации об участии в ДТП нет — в соответствующем поле заявки указывается «Данных о ДТП нет»
Если данные недоступны или произошла ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1,
"accidents": [
{
"model": "Nexia",
"mark": "DAEWOO",
"vehicleYear": "2012",
"accidentType": "Столкновение",
"regionName": "Тульская область",
"vehicleDamageState": "Повреждено",
"accidentDatetime": "22.09.2016 07:50",
"damageSvg": "https://parser-api.com/parser/gibdd_api/?damage_svg=01,08",
"damageDescription": [
"ПЕРЕДНИЙ БАМПЕР",
"КАПОТ",
"РЕШЕТКА РАДИАТОРА"
],
"vehicleSort": "1",
"vehicleAmount": "2",
"accidentPlace": "Краснодарский край, Краснодар, Карасунский",
"ownerOkopf": "ФИЗИЧЕСКИЕ ЛИЦА"
}
]
}
{
"success": 1,
"accidents": []
}
Эндпоинты для проверки автомобиля на этапе мониторинга
Для всех проверок автомобиля на этапе мониторинга используются только эти два query-параметра:
key
vin — VIN номер автомобиляI
1. Проверка появления ограничений на автомобиль
Метод: GET
Эндпоинт: parser/gibdd_api/restrict
Логика обработки запроса:
Запрос выполняется в автоматическом режиме ежедневно с 05:00 до 07:00
Если получены данные об ограничениях — система фиксирует дату регистрации залога, как дату продажи автомобиля и переводит заявку в новый статус в соответствии с требованием — Заявка. Статусная модель. В соответствующих полях заявки фиксируем данные:
Дата наложения ограничения
Вид ограничения
Дальнейший мониторинг прекращается
Если информация об ограничениях отсутствует, выполнение запроса повторяется на следующий день с 05:00 до 07:00
Если данные недоступны из-за ошибки запроса или технической проблемы, запрос повторяется каждые 30 минут. Если в течение дня (до 17:00) результат не получен, отобразить сообщение «Данные проверки недоступны» и продолжить выполнение запроса каждые 30 минут, до момента получения результата
{
"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": 1,
"restrictions": []
}
2. Проверка появления нового страхового полиса
Метод: GET
Эндпоинт: parser/osago_api
Логика обработки запроса:
Запрос выполняется в автоматическом режиме ежедневно с 05:00 до 07:00
В ответе ищется поле "Дата начала страхового периода"
Если дата начала страхового периода полиса больше или равна дате перевода заявки в статус «Оплачено» — фиксируем новую дату начала страхового периода, как дату продажи автомобиля и переводим заявку в новый статус в соответствии с требованием — Заявка. Статусная модель. В соответствующих полях заявки фиксируем данные:
Серия полиса
Номер полиса
Дата начала страхового периода
Дата окончания страхового периода
Статус полиса
Если Дата начала страхового периода меньше или равна дате перевода заявки в статус «Оплачено», выполнение запроса повторяется на следующий день с 05:00 до 07:00.
Если данные недоступны из-за ошибки запроса или технической проблемы, запрос повторяется каждые 30 минут. Если в течение дня (до 17:00) результат не получен, отобразить сообщение «Данные проверки недоступны» и продолжить выполнение запроса каждые 30 минут, до момента получения результата
{
"success": 1,
"policies": [
{
"companyName": "Страховое публичное акционерное общество \"Ингосстрах\"",
"policySerial": "ХХХ",
"policyNumber": "0451703060",
"vin": null,
"vin_mask": "Y4K8622Z3PB9*****",
"regNumber": null,
"regNumber_mask": "М2***А04",
"mark": "Geely",
"model": "Coolray",
"startDate": "2024-09-29",
"endDate": "2025-09-28",
"status": "Действует"
}
]
}
{
"success": 1,
"policies": []
}
3. Проверка появления нового владельца авто
Метод: GET
Эндпоинт: parser/gibdd_api/history
Логика обработки запроса:
Запрос выполняется в автоматическом режиме ежедневно с 05:00 до 07:00
В ответе ищется поле "Дата постановки на учёт"
Если дата постановки на учёт больше даты перевода заявки в статус «Оплачено» — фиксируем новую дату постановки на учёт, как дату продажи автомобиля и переводим заявку в новый статус в соответствии с требованием — Заявка. Статусная модель. В соответствующих полях заявки фиксируем данные:
Дата постановки на учёт
Дата снятия с учёта
Последняя операция
Если дата постановки на учёт меньше или равна дате перевода заявки в статус «Оплачено», выполнение запроса повторяется на следующий день с 05:00 до 07:00
Если данные недоступны из-за ошибки запроса или технической проблемы, запрос повторяется каждые 30 минут. Если в течение дня (до 17:00) результат не получен, отобразить сообщение «Данные проверки недоступны» и продолжить выполнение запроса каждые 30 минут, до момента получения результата
{
"success": 1,
"history": {
"engineVolume": "3990.0",
"color": "КРАСНЫЙ",
"bodyNumber": "Х9Н77А3ВJС0000513",
"year": "2012",
"engineNumber": "НС511259ХА01",
"vin": "Х9Н77А3ВJС0000513",
"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"
}
]
}
}
{
"success": 1,
"history": {}
}
Эндпоинты для проверки физлиц на этапе покупки автомобиля
1. Проверка нахождения в розыске
Метод: GET
Эндпоинт: parser/mvd_wanted_api
Параметры запроса:
key
firstName — имя
lastName — фамилия
patronymic — отчество
dob — дата рождения в формате YYYY-MM-DD
Логика обработки запроса:
Если лицо найдено в базе — система переводит заявку в статус «Отклонена по стоп-факторам»
Если лицо не найдено в базе, в соответствующем поле заявки указывается «Лицо не находится в розыске»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1,
"count": 1,
"records": [
{
"name": "МАХМУДОВ ФАХРУДИН АЛИБЕГОВИЧ"
}
]
}
{
"success": 1,
"count": 0,
"records": []
}
2. Проверка банкротства
Описание: Получение всей необходимой информации о физическом лице выполняется через последовательные запросы: сначала поиск самого физлица, затем если оно найдено получение списка сообщений о банкротстве и затем получение детальной информация по каждому сообщению
1. Поиск физического лица:
Метод: GET
Эндпоинт: /parser/fedresurs_api/search_fiz
Параметры запроса:
key
firstName — имя
lastName — фамилия
patronymic — отчество
Результат: получение в ответе id — идентификатор физлица, которое будет использовано для запроса сообщений о банкротстве
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "245", // общее число найденных записей
"records": [
{
"category": "Физическое лицо", // Категория должника
"debtor": "Петров Алексей Сергеевич", // ФИО должника
"inn": "301110252258", // ИНН
"ogrn": "315618400012345", // ОГРНИП (для ИП)
"snils": "153-649-617 88", // СНИЛС
"region": "Астраханская область", // Регион
"address": "416247, Астраханская обл., г. Камызяк, ул. Ленина, д. 25", // Адрес
"id": "B033421DBEEC3E0AC5E4057B08BA3858" // идентификатор для запроса детальной информации или списка сообщений
}
]
}
{
"success": 1,
"total_count": "0",
"records": []
}
2. Поиск сообщений о банкротстве по идентификатору физлица
Метод: GET
Эндпоинт: /parser/fedresurs_api/get_person_messages
Параметры запроса:
key
id — идентификатор физлица
Результат: получение в ответе id — идентификатор каждого сообщения для получения полной информации по нему
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "156", // общее количество сообщений
"records": [
{
"id": "2EA27B840541E8E81A14D50B68BE85C8", // идентификатор сообщения для запроса детальной информации
"date": "16.10.2025 14:48:09", // Дата публикации
"type": "Сообщение о собрании кредиторов", // Тип сообщения
"manager_name": "Смирнов Константин Петрович", // ФИО арбитражного управляющего
"manager_id": "91997569-a6c8-4c9f-9c67-7b9d39cbfd3d" // идентификатор арбитражного управляющего
}
]
}
3. Поиск детальной информации по каждому сообщению
Метод: GET
Эндпоинт: /parser/fedresurs_api/get_message
Параметры запроса:
key
id —идентификатор каждого сообщения
Результат: получение детальной информации по каждому сообщению о банкротстве
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"record": {
"id": "2EA27B840541E8E81A14D50B68BE85C8", // идентификатор сообщения
"act": "о завершении конкурсного производства", // Судебный акт
"act_type": "", // Тип судебного акта
"num": "4898769", // Номер сообщения
"date_published": "09.04.2020", // Дата публикации
"type": "Сообщение о судебном акте", // Тип сообщения
"debtor_name": "ДАЧНОЕ НЕКОММЕРЧЕСКОЕ ТОВАРИЩЕСТВО \"ВАСИЛЕК\" С ПРАВОМ ПРОПИСКИ", // Наименование/ФИО должника
"debtor_inn": "6101037720", // ИНН должника
"case_num": "А53-32631/2016", // Номер дела
"manager_name": "Смирнов Константин Петрович (ИНН 614110320620, СНИЛС 145-659-767 11)", // ФИО арбитражного управляющего
"text": "Решением Арбитражного суда Ростовской области по делу №А53–32631/2016 от 12.10.2017 в отношении дачного некоммерческого товарищества «Василек» введена процедура банкротства – конкурсное производство, должник признан банкротом...", // Текст сообщения
"relative_not_actual_id": null, // Идентификатор связанного аннулированного сообщения
"is_actual": 1, // 1 - не аннулировано, 0 - аннулировано
"dob": "15.03.1985", // Дата рождения должника (для физ. лиц)
"snils": "123-456-789 00" // СНИЛС должника (для физ. лиц)
}
}
3. Проверка действительности паспорта
Метод: GET
Эндпоинт: parser/passport_api
Параметры запроса:
key
passport_series — серия паспорта
passport_number — номер паспорта
first_name — имя
last_name — фамилия
Логика обработки запроса:
Если после "status" = "NOT_VALID" или "NOT_FOUND" — система переводит заявку в статус «Отклонена по стоп-факторам». В соответствующих полях заявки фиксируются:
Серия и номер паспорта
Имя и фамилия владельца
Статус паспорта
Если после "status" = "VALID", в соответствующем поле заявки указывается «Паспорт действителен»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1,
"status": "VALID"
}
{
"success": 1,
"status": "NOT_VALID"
}
{
"success": 1,
"status": "NOT_FOUND"
}
4. Проверка наличия судимости
Метод: GET
Эндпоинт: parser/sudrf_api
Параметры запроса для поиска дел:
key
text — текстовое поле для поиска (Иванов%20Иван%20Иванович)
Параметры запроса для получения детальной информации по делу:
key
caseID — идентификатор дела
Логика обработки запроса:
Если получен идентификатор дела (ID):
По этому ID выполняется второй запрос для получения детальной информации о деле
В зависимости от полученных данных система заполняет соответствующие поля по каждому делу:
Дата вынесения решения
Результат дела
ФИО
Тип участия
Статья
Если записи отсутствуют, в соответствующем поле заявки указывается «Информация о судимости отсутствует»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"sudrf_done": 1,
"total_count": 2,
"cases": [
{
"DocumentType": "Приговор",
"RegisterDate": "2018-07-26",
"Region": "Свердловская область",
"CourtName": "Свердловский областной суд",
"Instance": "Первая инстанция",
"Category": "Гл. 26 КАС РФ -> о присуждении компенсации...",
"Name": "Административное дело 33а-15217/2018",
"Id": "22cf58e86f6b6f9725145bf692357124",
"Snippet": "<em>Иванов Иван Иванович</em>"
}
]
}
{
"sudrf_done": 1,
"case": {
"EndDate": "2013-12-28",
"participants": [
{
"Type": "Нарушения, предусмотренные КоАП",
"Name": "Неволин А.В.",
"Category": "КоАП: ст. 20.1 ч.1"
}
],
"RegisterDate": "2013-12-28",
"Category": "КоАП: ст. 20.1 ч.1",
"Region": "Тульская область",
"CourtName": "Тульский областной суд",
"ProcessType": "Дело об административном правонарушении",
"Judge": "Тюрина О.А.",
"CaseNumber": "5-935/2013",
"history": [
{
"Date": "28.12.2013",
"Time": "11:50",
"Name": "Передача дела судье",
"Result": ""
}
],
"documents":[
{
"PublishDate" : "2017-11-22",
"Type": "Определение",
"Date": "2017-11-08",
"Text": "Дело № 33-6719/2017 АПЕЛЛЯЦИОННОЕ ОПРЕДЕЛЕНИЕ Санкт-Петербург"
}
],
"Result": "Вынесено постановление о назначении административного наказания"
}
}
{
"sudrf_done": 1,
"total_count": 0,
"cases": []
}
5. Проверка наличия долгов или исполнительных производств через
Метод: GET
Эндпоинт: parser/fssp_api/search_fiz
Параметры запроса:
key
firstName — имя
lastName — фамилия
patronymic — отчество
dob — дата рождения в формате YYYY-MM-DD
Логика обработки запроса:
Если получена информация о наличии исполнительных производств, в соответствующих полях заявки по каждому производству отображаются:
Дата возбуждения производства
Дата окончания/прекращения производства
Причина окончания/прекращения
ФИО участника
Сумма задолженности
Если исполнительные производства не найдены, в соответствующем поле заявки указывается «Исполнительные производства отсутствуют»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"done": 1,
"url": "https://fssp.gov.ru/search",
"total_rows_count": "2",
"total_pages_count": "1",
"result": [
{
"debtor_name": "Иванов Иван Иванович",
"debtor_address": "г. Москва, ул. Ленина, д. 1",
"debtor_dob": "1980-05-12",
"process_title": "Исполнительное производство №12345",
"process_date": "2024-01-15",
"process_total": "Исполнительное производство по алиментам",
"document_title": "Исполнительный лист №56789",
"document_organization": "Суд Московской области",
"document_claimer_inn": "7701234567",
"document_type": "Исполнительный лист",
"document_date": "2024-01-10",
"document_num": "56789",
"stop_date": null,
"stop_reason": null,
"subjects": [
{"title": "Алименты", "sum": "50000"}
],
"department_title": "Отдел судебных приставов г. Москва",
"department_address": "г. Москва, ул. Пушкина, д. 10",
"officer_name": "Петров П.П.",
"officer_phones": ["+7-495-123-45-67"],
"payment_available": 1
}
]
}
{
"done": 1,
"url": "https://fssp.gov.ru/search",
"total_rows_count": "0",
"total_pages_count": "0",
"result": []
}
6. Проверка физического лица по реестру террористов и экстремистов
Метод: GET
Эндпоинт: parser/ter_ext_api/search_fiz
Параметры запроса:
key
firstName — имя
lastName — фамилия
middleName — отчество
dob — дата рождения в формате YYYY-MM-DD
Логика обработки запроса:
Если лицо найдено в реестре — система переводит заявку в статус «Отклонена по стоп-факторам»
Если лицо не найдено в реестре, в соответствующем поле заявки указывается «Лицо не находится в реестре террористов и экстремистов»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
"found": 1, // Найдено ли лицо в реестре. 1 - найдено, 0 - не найдено
"records": [ // Массив найденных записей. Пустой массив если ничего не найдено
{
"text": "15389. СЫСОЕВ АЛЕКСАНДР СЕРГЕЕВИЧ*, 15.04.1983 г.р. , С. КАРАГАЙ ПЕРМСКОЙ ОБЛАСТИ;"
}
]
}
{
"success": 1,
"found": 0,
"records": []
}
Эндпоинты, которые одновременно используется для проверки и авто и физлиц
1. Проверка по реестру залогов
Метод: GET
Эндпоинт: parser/reestr_api
Проверка нахождения автомобиля в залоге на этапе покупки
Параметры запроса:
key
vin — VIN номер автомобиля
Логика обработки запроса:
Если получены данные о нахождении автомобиля в залоге — система должна перевести заявку в статус «Отклонена по стоп-факторам». При этом в заявке должны быть зафиксированы поля:
Дата регистрации залога
Номер уведомления о залоге
Если информация о нахождении автомобиля в залоге отсутствует — в соответствующем поле заявки указывается «Автомобиль не находится в залоге»
Если проверка не дала результата или вернулась ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"reestr_done": 1,
"records": [
{
"register_date": "2015-02-07",
"number": "2015-000-426318-974",
"pledgor_hidden": 0,
"pledgee_hidden": 1,
"objects": [
"VIN TMBLB25L9C6086447",
"VIN SALLMAMH4CA388911"
],
"pledgors": [
{
"type": "org",
"name": "ООО \"КМЗ\""
}
],
"pledgees": [
{
"type": "org",
"name": "Открытое акционерное общество «Сбербанк России»"
}
],
"history": [
{
"date": "01.06.2018 16:47",
"type": "Возникновение",
"number": "2018-002-340302-436"
},
{
"date": "02.07.2018 20:45",
"type": "Изменение",
"number": "2018-002-340302-436/1"
}
]
}
]
}
{
"reestr_done": 1,
"records": []
}
Проверка попадания автомобиля в залог на этапе мониторинга
Параметры запроса:
key
vin — VIN номер автомобиля
Логика обработки запроса:
Запрос выполняется в автоматическом режиме ежедневно с 05:00 до 07:00
Если получены данные о нахождении автомобиля в залоге — система фиксирует дату регистрации залога, как дату продажи автомобиля и переводит заявку в новый статус в соответствии с требованием — Заявка. Статусная модель. В соответствующих полях заявки фиксируем данные:
Дата регистрации залога
Номер уведомления о залоге
Залогодатели: наименование организации
Залогодержатели: наименование организации
Дальнейший мониторинг прекращается
Если информация о залоге отсутствует, выполнение запроса повторяется на следующий день с 05:00 до 07:00
Если данные недоступны из-за ошибки запроса или технической проблемы, запрос повторяется каждые 30 минут. Если в течение дня (до 17:00) результат не получен, отобразить сообщение «Данные проверки недоступны» и продолжить выполнение запроса каждые 30 минут, до момента получения результата
{
"reestr_done": 1,
"records": [
{
"register_date": "2015-02-07",
"number": "2015-000-426318-974",
"pledgor_hidden": 0,
"pledgee_hidden": 1,
"objects": [
"VIN TMBLB25L9C6086447",
"VIN SALLMAMH4CA388911"
],
"pledgors": [
{
"type": "org",
"name": "ООО \"КМЗ\""
}
],
"pledgees": [
{
"type": "org",
"name": "Открытое акционерное общество «Сбербанк России»"
}
],
"history": [
{
"date": "01.06.2018 16:47",
"type": "Возникновение",
"number": "2018-002-340302-436"
},
{
"date": "02.07.2018 20:45",
"type": "Изменение",
"number": "2018-002-340302-436/1"
}
]
}
]
}
{
"reestr_done": 1,
"records": []
}
Проверка физлица по реестру залогов
Параметры запроса:
key
firstName — имя
lastName — фамилия
patronymic — отчество
dob — дата рождения в формате YYYY-MM-DD
Логика обработки запроса:
Если обнаружены данные о залогах, в соответствующих полях заявки по каждому залогу отображаются:
Дата регистрации залога
Имущество под залогом
Залогодатели: ФИО лица
Залогодержатели: ФИО лица
Если информация о залогах отсутствует, в соответствующем поле заявки указывается «Залоги отсутствуют»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"reestr_done": 1,
"records": [
{
"register_date": "2015-02-07",
"number": "2015-000-426318-974",
"pledgor_hidden": 0,
"pledgee_hidden": 1,
"objects": [
"VIN TMBLB25L9C6086447",
"VIN SALLMAMH4CA388911"
],
"pledgors": [
{"type": "org", "name": "ООО \"КМЗ\""}
],
"pledgees": [
{"type": "org", "name": "Открытое акционерное общество «Сбербанк России»"}
],
"history": [
{"date": "01.06.2018 16:47", "type": "Возникновение", "number": "2018-002-340302-436"},
{"date": "02.07.2018 20:45", "type": "Изменение", "number": "2018-002-340302-436/1"}
]
}
]
}
{
"reestr_done": 1,
"records": []
}
2. Проверка арбитражных дел
Метод: GET
Эндпоинт: parser/ras_arbitr_api
Проверка авто по арбитражным производствам при покупке
Параметры запроса:
key
vin — VIN номер автомобиля
Логика обработки запроса:
Если получены данные об арбитражных делах — в соответствующих полях заявки по каждому делу отображаются:
Номер дела
Дата регистрации документа
Ссылка на дело на сайте арбитража
Ссылка на скачивание файла
Если информации об арбитражных делах нет — в соответствующем поле заявки указывается «Арбитражные дела отсутствуют»
Если данные недоступны или произошла ошибка — в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"done": 1,
"count": 1,
"pages": 1,
"page": 1,
"items": [
{
"CaseId": "c9babcc7-e797-429c-b6e4-6287b5d7334a",
"CaseUrl": "https://kad.arbitr.ru/Card/c9babcc7-e797-429c-b6e4-6287b5d7334a",
"RegistrationDate": "21.12.2018",
"InstanceNumber": "15АП-20855/2018",
"CaseNumber": "А53-30848/2015",
"FileName": "А53-30848-2015__20181221.pdf",
"FileUrl": "https://kad.arbitr.ru/PdfDocument/c9babcc7-e797-429c-b6e4-6287b5d7334a/b6e2f927-00ea-4dee-8fca-532a805c7362/А53-30848-2015__20181221.pdf?download=true",
"InstanceLevel": 2,
"Court": "15 арбитражный апелляционный суд",
"Type": "Постановление апелляционной инстанции",
"ContentTypes": [
"Оставить без изменения определение первой инстанции, а жалобу - без удовлетворения (ст.272 АПК)"
]
}
]
}
{
"done": 1,
"count": 0,
"pages": 0,
"page": 1,
"items": []
}
Проверка участия физлица в арбитражных делах на этапе покупки автомобиля
Параметры запроса:
key
inn — ФИО участника дела (Иванов%20Иван%20Иванович)
Логика обработки запроса:
Если обнаружены арбитражные дела, в соответствующих полях заявки по каждому делу отображаются:
Дата регистрации документа
Ссылка на скачивание файла
Если информация об арбитражных делах отсутствует, в соответствующем поле заявки указывается «Арбитражные дела отсутствуют»
Если данные недоступны из-за ошибки запроса или технической проблемы, в соответствующем поле заявки указывается «Данные проверки недоступны»
{
"done": 1,
"count": 1,
"pages": 1,
"page": 1,
"items": [
{
"CaseId": "c9babcc7-e797-429c-b6e4-6287b5d7334a",
"CaseUrl": "https://kad.arbitr.ru/Card/c9babcc7-e797-429c-b6e4-6287b5d7334a",
"RegistrationDate": "21.12.2018",
"InstanceNumber": "15АП-20855/2018",
"CaseNumber": "А53-30848/2015",
"FileName": "А53-30848-2015__20181221.pdf",
"FileUrl": "https://kad.arbitr.ru/PdfDocument/c9babcc7-e797-429c-b6e4-6287b5d7334a/b6e2f927-00ea-4dee-8fca-532a805c7362/А53-30848-2015__20181221.pdf?download=true",
"InstanceLevel": 2,
"Court": "15 арбитражный апелляционный суд",
"Type": "Постановление апелляционной инстанции",
"ContentTypes": [
"Оставить без изменения определение первой инстанции, а жалобу - без удовлетворения (ст.272 АПК)"
]
}
]
}
{
"done": 1,
"count": 0,
"pages": 0,
"page": 1,
"items": []
}
Особый случай обработки успешного запроса — 200
Если запрос к Parser-API выполнен успешно, но источник данных временно недоступен, то в JSON ответе будет возвращено только "success: 0", массивы данных будут отсутствовать
{
"success": 0
}
Обработка ошибок
Все эндпоинты API используют одинаковую систему ошибок. Коды ошибок, структура ответов и рекомендации по их обработке одинаковы для всех типов проверок
Ошибка доступа — 400:
Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле "error_code" всегда равно "40001"
Пример ответа:
{
"error": "Empty vin",
"error_code": 40001
}
Ошибка доступа — 403:
Возникает, если проблема с ключом или превышен лимит
Возможные error_code:
40301 — Invalid access key
40302 — The subscription period has expired
40303 — Invalid IP
40304 — Day limit of requests exceeded
40305 — Month limit of requests exceeded
Пример ответа:
{
"error": "Invalid access key",
"error_code": 40301
}
