↑ API подсказок

API справочников: отделения Почты России

API работает со справочником «отделения Почты России». Предоставляет методы для полнотекстового поиска и выборки конкретной записи по идентификатору.

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

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

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "ТЕКСТ_ЗАПРОСА" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/postal_office

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

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "ИДЕНТИФИКАТОР_ЗАПИСИ_СПРАВОЧНИКА" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/postal_office

Параметры запроса

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

  • index
  • opsname
  • region
  • city
  • settlement

Выборка по идентификатору работает по полю index.

Фильтрация работает по полям 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 Дата актуальности

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

Стоимость

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

ajax-spinner

Зарегистрируйтесь, чтобы подключить API

до 10 тыс. запросов бесплатно

чтобы обращаться к вам в письмах

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

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