↑ Все API

API: отделения Почты России

Справочник отделений Почты России.

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

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

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/postal_office
            
            
{ "query": "москва 64" }

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

  • index
  • opsname
  • region
  • city
  • settlement

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

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

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

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

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

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

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

  • index

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

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

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

Фильтрация

Фильтрация работает по полям opstype, region и city:

{
  "query": "32",
  "filters": [
    {
      "region": "САМАРСКАЯ ОБЛАСТЬ",
      "city": "САМАРА"
    }
  ]
}

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

НазваниеОписание
valueЗначение одной строкой (как показывается в списке подсказок)
unrestricted_valueИндекс и название отделения одной строкой
data.indexПочтовый индекс
data.opsnameНазвание отделения
data.opstypeТип отделения
data.opssubmИндекс вышестоящего отделения
data.regionРегион
data.areaРайон в регионе
data.cityГород
data.settlementНаселённый пункт
data.actdateДата актуальности

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

Ограничения

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

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

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

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

Стоимость

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