API Суды общей юрисдикции города Москвы - API-CLOUD
Документация по работе с API Суды общей юрисдикции города Москвы

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
История изменений/обновлений API
Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа
HTTPS GET запрос: https://api-cloud.ru/api/mosgorsud.php

Обязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS.
Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
type
Обязательно		 Описание Параметры в запросе
Обязательно
В одном запросе возможно отправить только 1 тип
getValuesForFields Получить значения всех параметров поиска
• Справочник всех параметров поиска
 Обязательные
token - персональный ключ API
caseSearch Поиск дел
• Номер дела
• Номер материала
• Ссылка для метода "caseDetail" получения подробностей дела
• Текущее состояние
• Судья
• Статья
• Категория дела
• Участники дела
 Минимум 1 из параметров
caseNumber - Номер дела, материала, жалобы или производства
Маска: [A-Za-z0-9\-/]
uid - Уникальный идентификатор дела
Маска: [A-Za-z0-9\-/]
courtAlias - Суд, key из справочника (courtAlias)
Маска: [a-z]
instance - Инстанции, key из справочника (instance)
Маска: [0-9]
processType - Производства, key из справочника (processType)
Маска: [0-9]
category - Категория дела, key из справочника (Произодство -> categoryListByProcess)
Маска: [a-z0-9]
Обязательно должен быть передан параметр processType, а ключ массива categoryListByProcess соответствовать значению processType.
Например: Если processType=1, то массив со значениями берем из categoryListByProcess['Административаное']
judge - Судья, key из справочника (judge)
Маска: [А-ЯЁа-яё\s\-.]
publishingState - Текущее состояние дела, key из справочника (publishingState)
Маска: [A-Za-z0-9]
baseDecision - Основание решения суда, ey из справочника (baseDecision)
Маска: [A-Za-z0-9]
documentType - Вид документа, key из справочника (baseDecision)
Маска: [A-Za-z0-9]
documentStatus - Статус публикации докумета, key из справочника (documentStatus)
Маска: [0-9]
year - Год
Маска: [0-9]{4}
caseDateFrom - дата регистрации Начало
Маска: [дд.мм.гггг]
caseDateTo - дата регистрации Конец
Маска: [дд.мм.гггг]
caseFinalDateFrom - дата окончания Начало
Маска: [дд.мм.гггг]
caseFinalDateTo - дата окончания Конец
Маска: [дд.мм.гггг]
caseLegalForceDateFrom - дата вступления решения в силу Начало
Маска: [дд.мм.гггг]
caseLegalForceDateTo - дата вступления решения в силу Конец
Маска: [дд.мм.гггг]
docsDateFrom - дата документа Начало
Маска: [дд.мм.гггг]
docsDateTo - дата документа Конец
Маска: [дд.мм.гггг]
page - номер загружаемой страницы
Маска: [0-9]
Обязательные
token - персональный ключ API
caseDetail Получение детальной информации о деле
• Основная информация о деле
• Стороны
• Движения дела
• История местонахождения
• Судебные заседания
• Документы
 Обязательные
url - адрес дела на сайте mos-gorsud, полученный через метод caseSearch (Поиск дел)
Ссылка из метода : /rs/meshchanskij/services/cases/civil/details/e088bf16-37b6-4987-b1a2-5870f7db3b64
token - персональный ключ API
Пример отправки GET запроса на PHP:
function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ 
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/mosgorsud.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.
Примеры запросов

История изменений API Суды общей юрисдикции города Москвы

дата что изменилось

Возможные коды ошибок

код (error) Описание ошибки (message)
mgs-10 parameter documentStatus not documented
Значение параметра documentStatus не задокументировано
mgs-09 parameter documentType not documented
Значение параметра documentType не задокументировано
mgs-08 parameter baseDecision not documented
Значение параметра baseDecision не задокументировано
mgs-07 parameter publishingState not documented
Значение параметра publishingState не задокументировано
mgs-06 parameter judge not documented
Значение параметра judge не задокументировано
mgs-05 parameters processType-category not found
Нет связки параметров processType и category. Или указан параметр category без параметра processType
mgs-04 parameter category not documented
Значение параметра category не задокументировано
mgs-03 parameter processType not documented
Значение параметра processType не задокументировано
mgs-02 parameter instance not documented
Значение параметра instance не задокументировано
mgs-01 parameter courtAlias not documented
Значение параметра courtAlias не задокументировано
888 ИМЯ передаваемой переменной: forbidden symbols present
В переменной ИМЯ присутствуют запрещенные символы
766 MISSING_MANDATORY_PARAMETER
Отсутствуют обязательные параметры
602 TOKEN_NO_ACCESS
Нет доступа к запрашиваему методу запроса
504 TOKEN_LOCKED_IN_THE_SYSTEM
Переданный токен заблокирован службой качества / автоматической системой
503 TOKEN_NOT_REGISTERED_IN_THE_SYSTEM
Переданный токен не зарегистрирован в системе
502 MISSING_REQUIRED_TOKEN_PARAMETER
Отсутствует параметр token
500 MISSING_REQUIRED_TYPE_PARAMETER
Отсутствует параметр type
5 TEST_TIME_OFF
Закончился период тестирования
499 WRONG_TOKEN_KEY
Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498 TOKEN_NO_MONEY
Для выполнения запроса недостаточно средств, пополните баланс.
460 NO_REQUIRED_PARAMETERS
Отсутствуют обязательные параметры
456 MAX_LIMIT
Превышено количество одновременных соединений (потоки)
404 TIME_MAX_CONNECT
Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
3 TOKEN_BLOCKED_BY_QUALITY_SERVICE
Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
2 TOKEN_TEHBLOCK
Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
15 DATE_ERROR
Ошибка значения переданной даты
123 IP_NOT_REGISTERED_IN_THE_SYSTEM
Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111 PARAMETER_CONFLICT
Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
1 API_SUSPENDED
Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.
Пример ответа с ошибкой 

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