Skip to content

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

POST
/suggest/postal_unit

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

  • postal_code - индекс
  • address_str - адрес
Ссылки на официальную документацию:
https://dadata.ru/api/suggest/postal_unit/

Авторизация

ApiKey

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

Тип
API Key (header: Authorization)

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

application/json
object

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

@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

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

application/json
object

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

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

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

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

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

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

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

Песочница

Сервер
Авторизация
Тело запроса

Примеры кода

Создано с помощью VitePress OpenAPI