↑ Все API Полнотекстовый поиск (
Запись справочника по идентификатору (
API: отделения Почты России
Справочник отделений Почты России.
Чтобы вызвать метод, и подтвердите почту.
Полнотекстовый поиск (suggest)
Пример запроса:
POST https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/postal_office{ "query": "москва 64" }
Поиск работает по полям:
indexopsnameregioncitysettlement
Укажите при вызове:
Content-Type: application/json.Accept: application/json.${API_KEY}— API-ключ.
Тело запроса передавайте в кодировке UTF-8.
Запись справочника по идентификатору (findById)
Пример запроса:
POST https://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 тысяч запросов в день. Больше — в составе годовой подписки.