↑ Все API

API: муниципальные образования (ОКТМО)

Общероссийский классификатор территорий муниципальных образований.

Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

Полнотекстовый поиск (suggest)

Пример запроса:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "54623425" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/oktmo
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/oktmo";
var token = "${API_KEY}";
var query = "54623425";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new \Dadata\DadataClient($token, null);
$result = $dadata->suggest("oktmo", "54623425");
# https://github.com/hflabs/dadata-py

from dadata import DadataAsync
token = "${API_KEY}"
dadata = DadataAsync(token)
result = await dadata.suggest("oktmo", "54623425")

Поиск работает по полям:

  • oktmo

Запись справочника по идентификатору (findById)

Пример запроса:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "54623425" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/oktmo
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/oktmo";
var token = "${API_KEY}";
var query = "54623425";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new \Dadata\DadataClient($token, null);
$result = $dadata->findById("oktmo", "54623425");
# https://github.com/hflabs/dadata-py

from dadata import DadataAsync
token = "${API_KEY}"
dadata = DadataAsync(token)
result = await dadata.find_by_id("oktmo", "54623425")

Выборка по идентификатору работает по полям:

  • oktmo

Поля справочника

Название Описание
value = data.oktmo
unrestricted_value = data.oktmo
data.oktmo Код ОКТМО
data.area_type Тип муниципального района:
  1 — муниципальный район
  2 — городской округ
  3 — внутригородская территория города федерального значения
  4 — муниципальный округ
data.area_code Код муниципального района
data.area Название муниципального района
data.subarea_type Тип муниципального поселения:
  1 — городское поселение
  2 — сельское поселение
  3 — межселенная территория в составе муниципального района
  4 — внутригородской район городского округа
data.subarea_code Код муниципального поселения
data.subarea Название муниципального поселения

Источник данных: Росстат

Особенности использования

Оригинальный справочник ОКТМО содержит 4 уровня муниципальных образований:

  • регион
  • муниципальный район,
  • муниципальное поселение,
  • населенный пункт.

Справочник ОКТМО «Дадаты» содержит только 2 уровня — муниципальные районы и поселения. Это объекты с 8-значным кодом ОКТМО. Чтобы получить муниципальное образование по 11-значному коду ОКТМО, возьмите первые 8 цифр и отправьте в «Дадату».

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 20 в секунду.

Максимальная частота создания новых соединений — 60 в минуту.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.

ajax-spinner

Зарегистрируйтесь, чтобы подключить API
до 10 тыс. запросов в день — бесплатно
чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти