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

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

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

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

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/oktmo
            
            
                
                    { "query": "54623425" }

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

var url = "http://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 Dadata
token = "${API_KEY}"
dadata = Dadata(token)
result = dadata.find_by_id("oktmo", "54623425")

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

oktmo

Укажите при вызове:

Content-Type: application/json.
Accept: application/json.
${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

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

Название	Описание
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 символов.

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

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

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

Стоимость