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

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

  1. Зарегистрируйтесь и получите ключ
  2. Вызовите REST-метод, как в примерах ниже.

Полнотекстовый поиск (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

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

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

Код справочника: POSTAL_OFFICE

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

Стоимость

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

ajax-spinner

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

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

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

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

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