## Документация API ФССП розыск

### Поиск информации в реестре розыска по исполнительным производствам

Для поиска информации в реестре розыска Федеральной службы судебных приставов используйте следующий запрос:

```
https://service.api-assist.com/parser/fssp_search_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&lastName=ФАМИЛИЯ&firstName=ИМЯ&patronymic=ОТЧЕСТВО
```

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

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

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

```
https://service.api-assist.com/parser/fssp_search_api/?lastName=Иванова&firstName=Мария&patronymic=Андреевна&key=ВАШ_КЛЮЧ_ДОСТУПА
```

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

Ответ на запрос возвращается в формате JSON. Пример ответа:

```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`  
  Достигнут оплаченный лимит запросов на месяц.

**Пример ответа:**
```json
{
  "error": "Invalid access key",
  "error_code": 40301
}
```

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

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

**Пример ответа:**
```json
{
  "error": "Missing lastName in input params",
  "error_code": 40001
}
```