Формат запросов
JSON для поиска и проверки, multipart/form-data для подачи в суды, общий формат ответа, справочники.
Методы API бывают двух видов. Вид указан на странице каждого метода — там же полный адрес, поля и примеры.
| Поиск и проверка | Подача в суды и статусы обращений | |
|---|---|---|
| Адрес | https://api-yc.explorer.debex.ru/production/<метод> | https://explorer-proxy.debex.ru/api/<окружение>/<метод> |
| Запрос | POST, тело JSON | POST, multipart/form-data |
| Ответ | JSON: request_id, status, result | JSON с результатом подачи или статусами |
Поиск и проверка: JSON
Тело запроса — JSON, имена полей в формате snake_case (first_name, page_number).
curl -X POST https://api-yc.explorer.debex.ru/production/fssp-deals \
-H "X-Api-Key: <ваш ключ>" \
-H "Content-Type: application/json" \
-d '{"surname": "Иванов", "first_name": "Иван", "patronymic": "Иванович", "birthday": "01.01.1990"}'Ответ у всех таких методов одного вида:
| Поле | Что содержит |
|---|---|
request_id | Идентификатор запроса — назовите его менеджеру, если есть вопрос по ответу. |
status | Итог: ok — данные найдены, not_found — данных нет, остальные значения — ошибки. |
result | Найденные данные (при ok) или пояснение (при not_found). |
error | Текст ошибки (при ошибке). |
request_body | Запрос, как его понял сервис, — удобно для проверки имён полей. |
not_found — успешный ответ (HTTP 200): сервис отработал, но данных по запросу нет.
Подача в суды: multipart/form-data
Запрос состоит из данных заявления, документов и подписей:
| Часть запроса | Что передать |
|---|---|
заголовок X-Api-Key | Ключ клиента. |
заголовок Hidden-Authorization-Cookies | Cookies сессии портала — как получить. |
поле fillData | Данные заявления — JSON-строка. Состав полей — на странице метода. |
поля files | Документы (pdf, doc, docx) — по одному полю на файл. В fillData на документ ссылаются по номеру fileIndex — позиции среди files, с нуля. |
поля sigs + selfSign=1 | Готовые подписи .sig — если документы подписаны заранее; в том же порядке, что files. |
поле certificate + заголовок Hidden-Certificate-Pin | Файл подписи .pfx и пароль к нему — если документы должен подписать сервис. |
поле needFilesCompression | true — уменьшить pdf перед подачей. С готовыми подписями не используется: сжатие меняет файл. |
Подача занимает от нескольких секунд до нескольких минут: сервис входит на портал, подписывает и загружает документы. Ставьте таймаут ответа не меньше 5 минут и не повторяйте запрос, пока не получен ответ на предыдущий, — иначе заявление может уйти дважды.
Справочники
Коды судов, процессуальные статусы, типы процессов и другие значения для подачи — в справочниках.
Они доступны без ключа, метод GET, адрес — https://api-yc.explorer.debex.ru плюс путь:
| Справочник | JSON | Excel |
|---|---|---|
| ГАС «Правосудие» | /production/sudrf/dictionary | /production/sudrf/dictionary/xlsx |
| Жалобы на приставов (ФССП) | /production/fssp-gov-ru-appeal-main-dictionary | /production/fssp-gov-ru-appeal-main-dictionary/xlsx |
| Суды Москвы | /production/mossud/dictionary | /production/mossud/dictionary/xlsx |
| Мировые судьи Татарстана | /production/mirsudtatarstan/dictionary | /production/mirsudtatarstan/dictionary/xlsx |
| Мировые судьи Ставропольского края | /production/stavmirsud/dictionary | /production/stavmirsud/dictionary/xlsx |
| Мировые судьи ХМАО — Югры | /production/mirsud86/dictionary | /production/mirsud86/dictionary/xlsx |
| Мировые судьи Мордовии | /production/mirsudemordovia/dictionary | /production/mirsudemordovia/dictionary/xlsx |