API ФССП

Документация по работе с API ФССП

Таймаут: Установите таймаут ожидания минимум 120–400 секунд.

Эндпоинт

GET https://ru-api.ru/api/fssp?type={type}&token={key}&...

Аутентификация

Получите персональный ключ API (32 символа) и передавайте его в параметре token с каждым запросом.

Типы запросов

type	Описание	Параметры
`regionsList`	Список регионов Получить список регионов для параметра region. Плата не списывается.
`physical`	Поиск по физлицу Поиск исполнительных производств по физическому лицу	`lastname`* `firstname`* `secondname` `birthdate`* `region`*
`legal`	Поиск по юрлицу Поиск исполнительных производств по юридическому лицу	`nameLegal`* `region`* `address`
`ip`	Поиск по номеру ИП Поиск по номеру исполнительного производства	`number`*
`id`	Поиск по номеру ИД Поиск по номеру исполнительного документа	`number`* `region`
`inn`	Поиск по ИНН Поиск исполнительных производств по ИНН организации	`inn`* `region`

* — обязательный параметр. Все запросы также требуют параметр token.

Формат ответа

Успех:

{
  "status": 200,
  "source": "fssp",
  "type": "тип_запроса",
  "num": 3,
  "rez": [ ... ],
  "inquiry": {
    "price": 1.50,
    "speed": "5.2 сек",
    "attempts": 1,
    "balance": 498.50,
    "cached": false
  }
}

Ошибка:

{"error": "503", "message": "TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}

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

curl "https://ru-api.ru/api/fssp?type=regionsList&token=ВАШ_ТОКЕН"

Коды ошибок

Код	Описание
502	Отсутствует параметр token
503	Токен не зарегистрирован
499	Неверный формат токена
498	Недостаточно средств
500	Отсутствует параметр type
460	Отсутствуют обязательные параметры
404	Источник не найден
456	Превышен лимит одновременных соединений
1	API временно приостановлен