Компании могут оставить заявку на тестовое подключение API. Параметры ссылок можно использовать уже сейчас, чтобы открывать онлайн-сервисы с кадастровым номером или географической точкой.
Партнёрский API по кадастровому номеру
В ответе API предусмотрены адрес, кадастровая стоимость в рублях и другие характеристики земельного участка. Если доступны границы, ответ содержит контур в WGS 84 и координаты в МСК с номером зоны и отметкой калибровки.
В GeoJSON WGS 84 порядок координат — долгота, широта. В МСК northing — X (север), easting — Y (восток), оба значения в метрах. Поле msk.calibrated указывает, калибрована ли зона. Если координаты МСК недоступны, msk.calibrated равно null.
Полная документация API v1 — примеры запроса и ответа, схема координат и коды ошибок.
Как получить доступ к API
Чтобы подать заявку, откройте Telegram-бот «Мой участок», нажмите «Старт» и напишите «Нужен доступ к API». Укажите название компании и задачу интеграции.
Команда ответит по условиям подключения. Адрес API, логин, токен и лимит запросов выдадим по запросу через Telegram-бот.
Как отправить запрос после подключения
Отправьте GET по выданному HTTPS-адресу с параметром cad, например ?cad=69:44:0070119:11. Для HTTP Basic передайте логин, а в поле пароля используйте токен. В curl укажите --user ЛОГИН, затем введите токен по запросу программы.
При 200 данные возвращаются в объекте data. Код 401 означает, что учётные данные или период доступа не прошли проверку. При 429 повторите запрос через интервал из заголовка Retry-After.
Кадастровый номер через параметр cad
Передайте номер в формате ?cad=69:40:0100644:31. Валидное значение из ссылки имеет приоритет над ранее сохранённым номером и становится общим для всех сервисов на этом устройстве.
Точка WGS 84 через lat и lon
Для сервиса, которому достаточно одной точки, используйте ?lat=55.7558&lon=37.6176. Параметр lng допускается как технический синоним lon.
Координаты записываются с десятичной точкой: широта lat должна находиться в диапазоне от −90 до 90, а долгота lon или lng — от −180 до 180.
Одна точка не является границей участка
Координата из ссылки подходит только точечным расчётам. Площадь, размеры, ЗОУИТ и другие операции по контуру требуют кадастрового номера и доступных границ участка.