↑ Все 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 тысяч запросов в день. Больше — в составе годовой подписки.