API
Порядок подключения
При запросе ключа происходит регистрация в системе, на указанный email направляется токен для запросов подсудности по адресу.
Запрос подсудности необходимо отправить методом GET c параметрами, включая полученный токен и адрес запроса, как указано в примере.
Ответ приходит в формате json с рядом значений.
Ограничения
50 запросов/день тестовый доступ по токену.
Для увеличения лимита запросов, выберете один из тарифов в разделе Тарифы и оплата.
Описание ответа
data
техническая информация
data:last
количество оставшихся суточных запросов
data:status
1 (true) - успешно, 0 (false) - ошибка
data:error
текст ошибки
request
информация о запросе
request:address
запрошенный адрес
request:coords
запрошенные координаты
court_fs
информация о федеральном суде (райнном/городском)
court_fs:title
наименование суда
court_fs:address
адрес суда
court_fs:site
сайт суда
court_fs:email
email суда
court_fs:tel
телефон суда
court_ms
такая же информация об участке мирового судьи
Запрос с координатами
Запрос по координатам в отличие от запроса по адресу работает значительно быстрее.
При наличии и адреса и координат с регионом будут использоваться координаты ввиду их большей точности, адрес при этом игнорируется. При наличии адреса, координат, но отсутствии региона будет использован адрес.
С координатами должен быть передан параметр - код региона субъекта РФ (region=16).
Формат координат принимается с разделителем - пробелом. Если не удается найти суд по координатам, попробуйте поменять порядок расположения широты и долготы координат. Пример: не находит c "55.794340 49.099524", но найдет c "49.099524 55.794340".
Пример запроса cURL (php)
$token = "Токен"; // указать полученный токен // запрос по адресу $address = "Адрес"; // формат: Город, улица, дом $url = "https://podsudnost.ru/request.php?token=".$token."&address=".urlencode($address); // запрос по координатам $coords = "Координаты точки"; // формат: 49.099524 55.794340 $region_code = "Код региона"; // 16 $url = "https://podsudnost.ru/request.php?token=".$token."&coords=".urlencode($coords)®ion=$region_code; $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $data = curl_exec($curl); echo $data; curl_close($curl);
Пример ответа json
Пример обработки ответа php
$court = json_decode($data); if ($court->data->status == 1) { $court_title = $court->court_fs->title; $court_address = $court->court_fs->address; $court_site = $court->court_fs->site; $court_email = $court->court_fs->email; $court_phone = $court->court_fs->phone; } else { $error = $court->data->error; }