API территориальной подсудности
Определение районного/городского суда и участка мирового судьи по адресу или координатам. Возвращает данные суда и контакты.
Аутентификация
Каждый запрос требует параметр token. Токен — у каждого пользователя свой, выдаётся при регистрации, доступен в личном кабинете.
Безопасность: токен — серверный секрет. Не используйте его в клиентском JS, отправляйте запросы со своего сервера.
Эндпоинты
https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=&address=https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=&coords=lat lnghttps://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/account?token=Также поддерживается legacy URL https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/api/... — для обратной совместимости. Новые интеграции — на /v1/.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
token | string | да | Токен из личного кабинета |
address | string | один из | Адрес одной строкой. Город, улица, дом. Пример: «Москва, Тверская, 1» |
coords | string | один из | Координаты «широта долгота» через пробел. Пример: «55.755826 37.6173» |
Параметры address и coords взаимоисключающие. Передайте один из двух.
Примеры запросов
curl "https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=YOUR_TOKEN&address=Москва,+Тверская,+1"GET /v1/?token=YOUR_TOKEN&address=Москва,+Тверская,+1 HTTP/1.1
Host: api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai
Accept: application/jsonconst url = 'https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?token=YOUR_TOKEN'
+ '&address=' + encodeURIComponent('Москва, Тверская, 1');
const res = await fetch(url);
const data = await res.json();
console.log(data);import axios from 'axios';
const { data } = await axios.get('https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/', {
params: { token: 'YOUR_TOKEN', address: 'Москва, Тверская, 1' }
});
console.log(data);$.getJSON('https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/', {
token: 'YOUR_TOKEN',
address: 'Москва, Тверская, 1'
}, function(data) {
console.log(data);
});<?php
$params = http_build_query([
'token' => 'YOUR_TOKEN',
'address' => 'Москва, Тверская, 1',
]);
$ch = curl_init('https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?' . $params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);<?php
$params = http_build_query([
'token' => 'YOUR_TOKEN',
'address' => 'Москва, Тверская, 1',
]);
$response = file_get_contents('https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/?' . $params);
$data = json_decode($response, true);
print_r($data);import requests
r = requests.get('https://api.xn----7sbarabva2auedgdkhac2adbeqt1tna3e.xn--p1ai/v1/', params={
'token': 'YOUR_TOKEN',
'address': 'Москва, Тверская, 1',
})
data = r.json()
print(data)Попробовать
Отправит реальный GET-запрос к api с указанным токеном и адресом. Учитывается в дневном лимите.
Примеры ответов
Успех
{
"data": {
"last": 987.5,
"status": 1
},
"request": {
"address": "Москва, Тверская, 1",
"coords": null,
"court_fs": {
"code": "77RS0023",
"title": "Савеловский районный суд (Город Москва)",
"address": "125047, г. Москва, ул. Бутырский вал, д. 7, стр. 1",
"site": "https://mos-gorsud.ru/rs/savyolovskij http://savelovsky.msk.sudrf.ru",
"email": "info@23.msksud.ru savelovsky.msk@sudrf.ru",
"tel": "(499) 250-40-31"
},
"court_ms": {
"code": "77MS0370",
"title": "Судебный участок № 370 Тверского района",
"address": "109012, г. Москва, Новая площадь, д. 8, стр. 1",
"site": "http://mos-sud.ru/ms/370"
}
}
}data.status: 1— успех.0— ошибка.data.last— остаток запросов на день (free) / руб. до исчерпания (balance).court_fs— районный/городской суд.court_ms— участок мирового судьи.- Поля
email,telмогут отсутствовать — если данных в базе нет. site,emailмогут содержать несколько значений через пробел.- Если суд для адреса не найден в базе — соответствующее поле =
null.
Ошибка
{
"data": {
"status": 0,
"error": "Дневной лимит запросов исчерпан"
}
}HTTP-статус всегда 200. Признак ошибки — data.status === 0. Текст в data.error.
Ошибки
Все возможные тексты data.error и что делать клиенту:
| data.error | Что значит | Действие |
|---|---|---|
| Токен не передан | В запросе нет параметра token | Добавить параметр |
| Токен недействителен | Токен не существует или отозван | Проверить, при необходимости перевыпустить в /account |
| Доступ к API заблокирован | Аккаунт заблокирован администратором | Связаться с поддержкой |
| Недопустимый тип тарифа | Внутренняя ошибка состояния тарифа | Связаться с поддержкой |
| Не передан адрес или координаты | Нет ни address, ни coords | Передать один из параметров |
| Координаты должны быть в формате "долгота широта" (через пробел) | Неверный формат coords | Пример: 37.6173 55.755826 |
| Дневной лимит запросов исчерпан | У free-тарифа дневной лимит исчерпан, у balance — недостаточно средств | Подождать до следующих суток (free) или пополнить баланс (balance) |
| Не удалось получить данные геокодера | Временные проблемы со внешним геокодером | Повторить позже |
| Не удалось распознать адрес. Проверьте корректность написания. | Геокодер не нашёл координат для адреса | Уточнить адрес: город, улица, дом |
| Суды для указанного адреса не найдены в базе. Возможно, они ещё не добавлены | Адрес распознан, но в базе нет покрытия по этому региону | Связаться с поддержкой если регион должен быть в базе |
| Внутренняя ошибка сервера | Серверная ошибка | Повторить через минуту, при повторе — поддержка |
Лимиты и тарифы
Free
50 запросов в сутки. Бесплатно. Лимит обновляется в полночь по Москве.
data.last — остаток запросов на сегодня.
Balance
Оплата с баланса. Стоимость одного запроса — 1 руб. Баланс пополняется в личном кабинете.
data.last — остаток средств на балансе (руб.) до исчерпания.
Сменить тариф и пополнить баланс можно в личном кабинете. Лимиты меняются мгновенно.
OpenAPI
OpenAPI-спецификация описывает api в стандартном формате. Импортируется в Postman, Insomnia, Swagger UI одной кнопкой — сразу получите интерактивные доки и автогенератор клиентов.
Скачать openapi.json