KLADR API — это программный интерфейс для доступа к справочнику адресных объектов Российской Федерации, основанному на кодах КЛАДР и/или интеграции с реестром ФИАС. Интерфейс предназначен для автоматизированного поиска и валидации адресов, получения иерархической информации о регионах, муниципальных образованиях, населённых пунктах, улицах и домах. В типовых реализациях API предоставляет результаты в формате JSON или JSONP и поддерживает фильтрацию, постраничную выдачу и полнотекстовый поиск «в одну строку», что облегчает интеграцию с формами ввода и системами геокодирования.
Исторически KLADR (Классификатор адресов России) использовался как основной справочник административно-территориального деления и адресных объектов; с развитием ФИАС функции уточнения адресных данных и сопоставления с кадастровой информацией были расширены. Многие поставщики реализуют совместимые API, которые актуализируют данные по мере выхода официальных обновлений и предоставляют методы для поиска по коду, наименованию, типу объекта и родительским элементам.
- Поиск по иерархии: получение регионов, районов, городов, населённых пунктов, улиц и домов с учётом родительских связей.
- Полнотекстовый поиск: поддержка поиска «в одну строку» с разбором введённой строки на компоненты адреса и выдачей релевантных совпадений.
- Формат ответа: вывод структурированных данных в JSON/JSONP с полями для кода объекта, названия, типа, адресной строки и ссылок на родительские объекты.
- Фильтрация и сортировка: параметры для ограничения выборки по типу объекта, коду региона, префиксу названия и другим атрибутам.
- Постраничная выдача: поддержка пагинации и указания размера страницы для эффективной обработки больших наборов результатов.
- Валидация адресов: методы проверки существования адресного объекта и сопоставления компонентов введённого адреса с официальным справочником.
- Совместимость с ФИАС: возможность объединения сведений КЛАДР и ФИАС для получения более точных идентификаторов и истории изменения объектов.
- Массовые запросы: конечные точки для пакетной обработки списков адресов или кодов с возвратом структурированных результатов.
- Метаданные и обновления: информация о версии справочника, датах актуализации и возможностях синхронизации локальных копий.
- Безопасность и доступ: типовые механизмы аутентификации и ограничения по количеству запросов в применённых коммерческих и публичных реализациях API.