API для kad.arbitr.ru — подробное руководство для программиста

6 часов назад
СУДиДЕЛО.рф
1 минута

В этом разделе приводится подробное описание для работы с системой КАД АРБИТР через открытое АПИ (open api service). Данное справочное руководство направлено на программистов и системных администраторов, которым необходимо интегрировать свои информационные системы реестром арбитражных дел КАД АРБИТР.

Общая схема работы

  1. Зарегистрируйтесь в системе
  2. Получите API ключ в разделе: Интеграция — API
  3. Вызывайте нужные методы АПИ, для получения данных о судебных арбитражных делах из системы КАД АРБИТР.

Регистрация в системе

Для регистрации в системе и получения API ключа, необходимо указать ваш Email и название организации.

Перейдите на форму регистрации: СУДиДело — регистрация пользователя

Укажите ваш Email и название компании. Рекомендуем указывать рабочий Email, на который система будет присылать различные уведомления по судебным делам. Изображение формы регистрации вы можете увидеть на следующем рисунке:

Форма регистрации в системе для доступа к АПИ кад арбитр

Получение API ключа для КАД АРБИТР

После того, как вы прошли регистрацию, вам необходимо получить API ключ.

Перейдите в раздел: Интеграция — API

Раздел с АПИ для доступа к арбитражным делам

В верхней части раздела будет доступен ваш API ключ для работы с судебными делами.

получение ключа для КАД АРБИТРА

Ключ (API KEY) представляет собой строковый идентификатор GUID и предназначен для авторизации пользователя при вызове методов АПИ. Храните ключ в надежном месте. Пример ключа для пользователя: 279b54bf-7fc5-4ca7-8d50-1d886c34d2f1

Добавление арбитражного дела

Для получения информации об арбитражном деле, его необходимо добавить в систему. Для этого нужно использовать метод АПИ: https://api-sudodelo.torkndgov.ru/index.html#/CourtCases/CreateCourtCase

Пример с параметрами для вызова АПИ метода добавления арбитражного дела:

{
  "apiKey": "279b54bf-7fc5-4ca7-8d50-1d886c34d2f1",
  "courtCase": {
    "numberCase": "А23-8785/2025",
    "numberCaseInCourt": "",
    "numberCaseUID": "",
    "urlLinkCase": "https://kad.arbitr.ru/card/523a1650-18f5-4140-b201-f0fc59631fee",
    "nameCourt": ""
  },
  "client": {
    "nameCompany": "Моя компания",
    "fio": "Иванов Иван Иванович",
    "email": "ivanov@mail.ru"
  }
}

Пример вызова метода добавления судебного дела вы можете увидеть на следующем рисунке:

Параметры создания арбитражного дела

Пример вызова метода с помощью curl:

curl -X 'POST' \
  'https://api-sudodelo.torkndgov.ru/api/CourtCases' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json' \
  -d '{
  "apiKey": "279b54bf-7fc5-4ca7-8d50-1d886c34d2f1",
  "courtCase": {
    "numberCase": "А23-8785/2025",
    "numberCaseInCourt": "",
    "numberCaseUID": "",
    "urlLрinkCase": "https://kad.arbitr.ru/card/523a1650-18f5-4140-b201-f0fc59631fee",
    "nameCourt": ""
  },
  "client": {
    "nameCompany": "Моя компания",
    "fio": "Иванов Иван Иванович",
    "email": "ivanov@mail.ru"
  }
}'

Описание параметров метода:

apiKey - ваш ключ API
numberCase - номер арбитражного дела
urlLinkCase - ссылка на арбитражное дело в системе КАД АРИБТР
client - информация о клиенте (доверителе) для которого ведется это дело в суде. Можно передать пустые строки.

После вызова метода, судебное дело будет создано в разделе: Реестр судебных дел

Вы сможете смотреть информацию о судебном деле в интерфейсе системы или получать все данные с помощью API: API методы для работы с судебными делами