## Документация API получения информации по делу на сайте суда (СУДРФ)

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

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

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

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

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

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

```
https://service.api-assist.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. Пример ответа:

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

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

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

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

**Пример ответа:**
```json
{
  "error": "url must contain sudrf.ru",
  "error_code": 40001
}
```