Формат і доступ
- Формати
- GET API, JSON, XML
- Спосіб отримання
- address-classifier-ws на www.ukrposhta.ua. Документація описує пошук області, району, населеного пункту, вулиці, номера будинку та індексу.
- Авторизація
- Bearer у заголовку Authorization; документація передбачає отримання в додатку до договору. Для JSON потрібен Accept: application/json.
- Охоплення
- Поштове обслуговування адрес; повноту всіх адрес України не перевірено.
- Обмеження
- Документація орієнтує на інтерактивний пошук, кешування й повторні запити із затримкою. Масове вивантаження не тестувалося.
Переглянуто документацію v3.21. Запитів із токеном не виконували.
Офіційне джерело ↗Як часто оновлюється
У джерелі
За змінами у видавця; гарантований інтервал у цій перевірці не встановлено.
Як перевіряти у своїй системі
Пропозиція: інтерактивний пошук із кешем; звірка індексу перед відправленням.
Рекомендація щодо перевірки не є гарантією видавця або активним розкладом Ладу.
Як отримати дані
- Зберегти джерело, версію, умови використання та дату отримання.
- Зіставляти із внутрішніми записами через окремі відповідності.
Як зберігати та пов’язувати
Ключі записів
- REGION_ID, DISTRICT_ID, CITY_ID, STREET_ID у просторі Укрпошти
- POSTCODE зберігати текстом; КАТОТТГ у відповіді звіряти з офіційним набором
Межі й типові помилки
- Поштовий індекс не є унікальним ID будинку.
- Порожня відповідь може бути наслідком обмеження навантаження або відсутності параметрів.
Перед повторним поширенням перевірте умови використання конкретного ресурсу та збережіть атрибуцію. Відкритий перегляд і права на повторне використання описуються окремо.