Получение информации по делу

Для получения информации по делу на сайте суда используйте следующий запрос:

https://parser-api.com/parser/sudrf_custom_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&url=URL_ДЕЛА

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

• key — ключ доступа к сервису (обязательный).
• url — URL дела на сайте суда, обязательно urlencoded (обязательный).

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

https://parser-api.com/parser/sudrf_custom_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&url=https%3A%2F%2Fkrasnogorsk--mo.sudrf.ru%2Fmodules.php%3Fname%3Dsud_delo%26srv_num%3D1%26name_op%3Dcase%26case_id%3D142483664%26case_uid%3Dd0840c49-bdf4-46bd-9d21-2aee11910ccc%26delo_id%3D1540005%26new%3D

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

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

{
  "success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
  "title": "Производство в суде первой инстанции", // заголовок таблицы с основной информацией по делу
  "type_title": "Производство по гражданским и административным делам", // тип производства
  "case_title": "ДЕЛО № 2-632/2020 ~ М-608/2020", // заголовок дела
  "court_title": "Алейский городской суд Алтайского края", // наименование суда
  "court_address": "454000, г. Челябинск, ул.Кирова, д. 161", // адрес суда
  "court_phone": "(351) 728-76-01, 728-76-51 (ф.)", // телефон суда
  "court_email": "7kas@sudrf.ru", // email суда
  "document_name": "Определение", // наименование документа
  "document_url": "/modules.php?name=sud_delo&srv_num=1&name_op=doc&number=13423456&delo_id=4&new=4&text_number=1", // ссылка на документ
  "attributes": [ // основные атрибуты дела
    {
      "name": "Уникальный идентификатор дела", // наименование
      "value": "50RS0021-01-2019-004289-49" // значение
    },
    {
      "name": "Дата поступления",
      "value": "05.11.2019"
    },
    {
      "name": "Номер по предыдущей регистрации",
      "value": "2-5688/2019 ~ М-3554/2019"
    },
    {
      "name": "Категория дела",
      "value": "Отношения, связанные с защитой прав потребителей >О защите прав потребителей >- из договоров в сфере: >строительных и связанных с ними инженерных услуг"
    },
    {
      "name": "Судья",
      "value": "Брижевская И.П."
    },
    {
      "name": "Признак рассмотрения дела",
      "value": "Рассматривается единолично судьей"
    }
  ],
  "events": [ // движения дела
    [
      {
        "name": "Наименование события", // наименование атрибута события
        "value": "Регистрация иска (заявления, жалобы) в суде и принятие его к производству" // значение
      },
      {
        "name": "Дата",
        "value": "05.11.2019"
      },
      {
        "name": "Время",
        "value": "16:07"
      },
      {
        "name": "Зал судебного заседания",
        "value": ""
      },
      {
        "name": "Результат события",
        "value": ""
      },
      {
        "name": "Основание для выбранного результата события",
        "value": ""
      },
      {
        "name": "Примечание",
        "value": ""
      },
      {
        "name": "Дата размещения",
        "value": "08.11.2019"
      }
    ]
  ],
  "sides": [ // стороны
    [
      {
        "name": "Вид лица, участвующего в деле", // наименование атрибута стороны
        "value": "ОТВЕТЧИК" // значение
      },
      {
        "name": "Фамилия / наименование",
        "value": "ООО \"Экоквартал\""
      },
      {
        "name": "ИНН",
        "value": ""
      },
      {
        "name": "КПП",
        "value": ""
      },
      {
        "name": "ОГРН",
        "value": ""
      },
      {
        "name": "ОГРНИП",
        "value": ""
      }
    ],
    [
      {
        "name": "Вид лица, участвующего в деле",
        "value": "ТРЕТЬЕ ЛИЦО"
      },
      {
        "name": "Фамилия / наименование",
        "value": "Фонд специальных проектов"
      },
      {
        "name": "ИНН",
        "value": ""
      },
      {
        "name": "КПП",
        "value": ""
      },
      {
        "name": "ОГРН",
        "value": ""
      },
      {
        "name": "ОГРНИП",
        "value": ""
      }
    ],
    [
      {
        "name": "Вид лица, участвующего в деле",
        "value": "ИСТЕЦ"
      },
      {
        "name": "Фамилия / наименование",
        "value": "Шашина Марина Михайловна"
      },
      {
        "name": "ИНН",
        "value": ""
      },
      {
        "name": "КПП",
        "value": ""
      },
      {
        "name": "ОГРН",
        "value": ""
      },
      {
        "name": "ОГРНИП",
        "value": ""
      }
    ]
  ],
  "enforcement_orders": [ // исполнительные листы
    [
      {
        "name": "Дата выдачи",
        "value": "30.09.2020"
      },
      {
        "name": "Серия, номер бланка",
        "value": "ФС № 028683952"
      },
      {
        "name": "Статус",
        "value": "Выдан"
      }
    ]
  ],
  "appeals": [ // обжалования
    [
      {
        "name": "Дата поступления",
        "value": "28.09.2020"
      },
      {
        "name": "Вид жалобы (представления)",
        "value": "Апелляционная (кассационная до 2013г) жалоба"
      },
      {
        "name": "Заявитель",
        "value": "защитником (АДВОКАТОМ)"
      },
      {
        "name": "Дата решения по поступившей жалобе",
        "value": "28.09.2020"
      },
      {
        "name": "Решение по поступившей жалобе",
        "value": "Жалоба (предст.) ПРИНЯТА К РАССМОТРЕНИЮ"
      }
    ]
  ]
}

Интерпретация ответа и обработка ошибок

Общие рекомендации:

• Если поле 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": "url must contain sudrf.ru",
  "error_code": 40001
}