postal_unit

---

Подсказки по отделениям Почты России

POST

/suggest/postal_unit

Поиск выполняется по полям:

• postal_code - индекс
• address_str - адрес

Авторизация

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Тип

API Key (header: Authorization)

Формат запроса

application/json

object

См. https://dadata.ru/api/suggest/postal_unit/

Адрес строкой или почтовый индекс

@example { "query": "дежнева 2а" } // по адресу
@example { "query": "105" } // все отделения с индексом, начинающимся на 105
@maxLength 300

Макс. длина300

Максимальное количество результатов.
@minimum 1
@maximum 20
@default 10

Минимум1

Максимум20

По умолчанию10

object[]

Фильтрация почтовых отделений

• Поля внутри одного фильтра интерпретируются как AND, между фильтрами - как OR

Фильтрация по признаку открыто/закрыто. false - искать только открытые, true - только закрытые

Фильтрация по типу отделения (например, ГОПС)

Фильтрация по населённому пункту отделения. Например '6300000100000' (КЛАД-код города)

Ответы API

Запрос успешно обработан

Content-Type

application/json

object

Объект с массивом подсказок

object[]

Обязательный

Массив подсказок или пустой массив

Почтовый индекс

Адрес отделения одной строкой

object

Обязательный

Подробности об отделении