ИНТЕГРАЦИЯ

Разработчикам

Инструкция по подключению партнёрского API «Моего участка» и примеры ссылок с кадастровым номером или координатами.

ИНТЕГРАЦИЯ

Партнёрский API и параметры ссылок

Компании могут оставить заявку на тестовое подключение 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.

Одна точка не является границей участка

Координата из ссылки подходит только точечным расчётам. Площадь, размеры, ЗОУИТ и другие операции по контуру требуют кадастрового номера и доступных границ участка.