Дані та API

API для перевірки данських адрес і номерів телефону

2026-10-01 · 8 хв читання

Майже кожна данська веб-форма рано чи пізно запитує адресу або номер телефону — на сторінці оплати, при бронюванні, у формі заявки, в анкеті орендаря. І майже кожна з них робить одні й ті самі дрібні помилки: поле адреси приймає "Nørrebro" без поштового індексу, поле телефону спокійно приймає "12 34" і вважає це коректним номером, назва міста не збігається з індексом, який клієнт щойно вписав поруч. Жодна з цих помилок не виглядає критичною сама по собі, але разом вони перетворюються на невдалі доставки, SMS-підтвердження, які нікуди не доходять, і звернення в підтримку, яких могло б не бути, якби форма мала кілька рядків валідації.

Для адрес рішення просте: перестати довіряти вільному тексту й перевіряти дані за реальним набором даних. Danadresse.dk — це DAWA-сумісний API, що охоплює близько 2,7 мільйона офіційних данських адрес, тож форма може пропонувати автодоповнення під час введення й приймати лише адресу, яка справді існує, з автоматично підставленим правильним поштовим індексом і муніципалітетом. Оскільки API повторює ту саму структуру, яку данські розробники вже знають із DAWA, підключення зазвичай зводиться до того, щоб спрямувати наявну інтеграцію на новий endpoint, а не переписувати логіку роботи з адресами з нуля. Результат відчутний одразу: більше жодних сумнівів, чи "Århus" і "Aarhus" — одне й те саме місце, і жодних адрес доставки, які виглядають правдоподібно, але насправді не існують.

Номери телефонів заслуговують на таку ж обережність, але з іншої причини. Данський мобільний або стаціонарний номер має передбачувану форму, проте "схоже на номер" і "є реальним, діючим номером" — не те саме. Форма реєстрації, сайт оголошень чи анкета орендаря, яка приймає будь-які вісім цифр, — це відчинені двері для фейкових акаунтів і одноразових номерів. Nummeropslag.dk надає пошук за данськими номерами — зокрема, чи позначався номер як спам — що корисно не лише для класичного "хто мені щойно дзвонив", а й як легка перевірка здорового глузду у формі реєстрації чи оголошення, перш ніж лід передадуть відділу продажів, який інакше витратить на нього час даремно.

На практиці ці два підходи добре поєднуються. Форма для лідів, яка перевіряє адресу через Danadresse і номер телефону перед прийняттям заявки, передає відділу продажів чи підтримки ліди, які з набагато більшою ймовірністю реальні — а це важить більше, ніж здається, коли комусь доводиться опрацьовувати список вручну. Завдання імпорту даних у CRM може прогнати ті самі дві перевірки пакетно, щоб прибрати роки накопичених друкарських помилок і мертвих номерів, перш ніж хтось сяде дивитися дані вручну. А на стороні обробки дзвінків такий інструмент, як LynBro PBX, може використати той самий запис у CRM, коли клієнт передзвонює, замість того, щоб починати розмову з нуля.

Перевірка адреси через API: конкретний приклад

DAWA закрився 1 жовтня 2026 року (див. наш посібник з міграції), але схема та сама, що й раніше: клієнт вводить текст, форма питає API адрес, і приймається лише вибрана підказка. З Danadresse виклик виглядає так. Безкоштовний ключ можна отримати на danadresse.dk, він передається в заголовку X-Api-Key:

// Server-side: the key stays out of the browser
const res = await fetch(
  'https://api.danadresse.dk/autocomplete?type=adresse&q=' + encodeURIComponent(q),
  { headers: { 'X-Api-Key': process.env.DANADRESSE_API_KEY } }
);
const hits = await res.json();
// hits[0].tekst → 'Rådhuspladsen 1, 1550 København V'

Збережіть id адреси з вибраної підказки разом із замовленням, і у вас будуть поштовий індекс, комуна й координати без розбору тексту потім. Для наявних даних, що вже лежать вільним текстом, є /datavask/adresser: він повертає найкращий офіційний збіг і категорію. A означає надійний збіг, B ймовірний, а C варто переглянути людині.

API поштових індексів: місто за індексом

Найменша перевірка з найбільшим ефектом — індекс → місто: клієнт вводить чотири цифри, і назва міста підставляється сама. Це на одне поле менше, без варіантів написання на кшталт «Kbh. Ø», а неіснуючий індекс видно одразу. З Danadresse це один запит до /postnumre/{nr}:

// 2100 → 'København Ø'
const res = await fetch('https://api.danadresse.dk/postnumre/' + zip, {
  headers: { 'X-Api-Key': process.env.DANADRESSE_API_KEY }
});
if (res.ok) city.value = (await res.json()).navn;

Відповідь 404 означає, що такого індексу нема, і поле можна одразу позначити. Якщо зручніше показувати підказки під час введення («21» → 2100, 2150 …), /postnumre/autocomplete?q= повертає список індексів і міст.

Підказки адреси під час введення

Для самого поля адреси використовуйте /autocomplete, як у прикладі вище: надсилайте введене, показуйте перші підказки й приймайте лише вибрану. Запит ведіть через власний сервер, щоб ключ API не потрапляв у браузер, і чекайте 150–200 мс після останнього натискання — так поле працює швидко без запиту на кожну літеру.

Формат данського номера можна перевірити локально ще до будь-якого запиту: вісім цифр, за бажанням з +45 на початку, і перша цифра не 0 і не 1.

const digits = input.replace(/[\s\-().]/g, '');
const ok = /^(?:\+45|0045)?[2-9]\d{7}$/.test(digits);

Перевірка формату ловить описки. Чи номер діє і чи на нього скаржились як на спам, покаже лише запит до сервісу на кшталт Nummeropslag.dk.

Жодна з цих речей не потребує великих інженерних зусиль — обидва API створені саме для такої легкої інтеграції, і більшість команд можуть підключити автодоповнення адреси або перевірку номера за одне робоче пообіддя, а не за цілий спринт. Якщо формі, процесу оплати чи завданню імпорту даних у данському коді могла б стати в пригоді будь-яка з цих перевірок, а часу на її впровадження не знайшлося, зв'яжіться з нами, і ми допоможемо її підключити.

Часті запитання

Який API адрес використовувати тепер, коли DAWA закрито?

Офіційний шлях — Datafordeleren: потрібна реєстрація й нова інтеграція. Danadresse.dk сумісний з DAWA, тож наявній інтеграції зазвичай вистачає нової базової адреси та ключа API.

Чи є безкоштовний API данських поштових індексів?

Так. З безкоштовним ключем Danadresse.dk можна за індексом отримати назву міста. Індекси змінюються рідко, тож відповідь можна кешувати.

Як перевірити адресу, яку клієнт уже ввів?

Надішліть текст на /datavask/adresser. Ви отримаєте найкращий офіційний збіг і категорію A, B або C, тож людині лишиться переглянути тільки сумнівні адреси.

Чи можна тримати ключ API в JavaScript сторінки?

Ні. Викликайте API зі свого сервера або невеликої проксі-функції, а браузер нехай звертається лише до неї.

Пов'язані статті

Готові перейти через міст?

Давайте побудуємо ваш блискавичний міст до цифрової трансформації. Від першої консультації до розгортання — ми рухаємося швидко.

Розпочати сьогодні