Поиск информации в реестре розыска по исполнительным производствам
Для поиска информации в реестре розыска Федеральной службы судебных приставов используйте следующий запрос:
https://parser-api.com/parser/fssp_search_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&lastName=ФАМИЛИЯ&firstName=ИМЯ&patronymic=ОТЧЕСТВО
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- lastName — фамилия физического лица (обязательный).
- firstName — имя физического лица (обязательный).
- patronymic — отчество физического лица (необязательный).
Пример запроса:
https://parser-api.com/parser/fssp_search_api/?lastName=Иванова&firstName=Мария&patronymic=Андреевна&key=ВАШ_КЛЮЧ_ДОСТУПА
Пример ответа на запрос:
Ответ на запрос возвращается в формате JSON. Пример ответа:
{
"success": 1, // флаг успешности выполнения запроса (1 — успешно, 0 — ошибка)
"total_rows_count": 1, // общее количество найденных записей
"total_pages_count": 1, // общее количество страниц с результатами
"result": [ // массив с результатами поиска, содержащий:
{
"search_category": "должник — физическое лицо", // категория поиска
"search_title": "13301/77/44/25", // номер розыскного дела
"search_date": "2025-02-12", // дата розыскного дела
"process_title": "293775/24/77044-ИП", // номер исполнительного производства
"process_date": "2024-10-14", // дата исполнительного производства
"debtor_name": "ИВАНОВА МАРИНА АЛЕКСЕЕВНА", // ФИО должника
"debtor_dob": "1988-06-25", // дата рождения должника
"department_title": "СМО по ИДРЗ", // наименование отдела судебных приставов
"department_address": "123423, Россия, г. Москва, , , , Маршала Жукова пр-кт, д. 35, корп. 1,", // адрес отдела судебных приставов
"department_phone": "" // телефон отдела судебных приставов
}
]
}
Интерпретация ответа и обработка ошибок
Общие рекомендации:
- Если поле
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
Достигнут оплаченный лимит запросов на месяц.
Пример ответа:
{
"error": "Invalid access key",
"error_code": 40301
}
3. Код ответа - 400
Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле error_code всегда равно 40001, подробности доступны в поле error.
Пример ответа:
{
"error": "Missing lastName in input params",
"error_code": 40001
}
