API даних

danadresse.dk: сумісний із DAWA адресний API, готовий до закриття DAWA

Коли 1 жовтня 2026 року закрився державний адресний API DAWA, наш сумісний REST API вже працював: ті самі шляхи й відповіді, нова базова адреса та ключ.

Проблема

Понад десять років DAWA був безкоштовним адресним API за данськими формами оформлення замовлень, CRM-системами й логістичними програмами. Щойно оголосили про закриття, кожна інтеграція, яка зверталася до dawa.aws.dk напряму, отримала дедлайн. Офіційний шлях веде через Datafordeleren: потрібна реєстрація й переписування під інші ендпоінти та інші формати відповідей. Для інтернет-магазину з полем адреси в кошику чи розробника, який супроводжує сайти кількох клієнтів, це реальна робота, яка сама по собі не дає бізнесу нічого нового.

Після 1 жовтня 2026 року DAWA відповідає HTTP 410 Gone. Поля адреси перестають щось підказувати, форми відхиляють правильні адреси, нічні задачі падають, і ніхто цього не помічає. Нам був потрібен вихід, який змінює якнайменше в чужому коді. До того ж наші власні продукти, зокрема bkg.dk і jatid.dk, теж потребували данських адрес, тож першими користувачами були ми самі.

Що ми побудували

Ми зробили danadresse.dk як пряму заміну. Шляхи й формат JSON повторюють DAWA: autocomplete, adresser, adgangsadresser, datavask, зворотне геокодування, postnumre, vejnavne, kommuner і потік реплікації з порядковими номерами подій. Ідентифікатор id_lokalId з реєстру DAR — той самий UUID, що був у DAWA, тож id адрес, які вже лежать у базі клієнта, працюють і після переходу. На практиці інтеграція міняє базову адресу з dawa.aws.dk на api.danadresse.dk і додає заголовок X-Api-Key.

Поверх ядра DAWA ми додали те, чого бракувало нашим продуктам: перевірку IBAN, CVR, данських телефонних номерів і EAN за контрольними цифрами, відстань і оцінку якості адреси, збагачення даними муніципалітетів і компаній, а також пакетне очищення файлів розміром до 50 МБ. Кожен акаунт отримує робочі й тестові ключі. Ми зберігаємо лише хеш і останні чотири символи, а браузерні ключі можна прив'язати до доменів клієнта.

ETL завантажує дані з офіційних джерел, а Meilisearch індексує їх для пошуку під час набору. Оплата йде через Stripe з лічильником використання, тож клієнт платить за реально зроблені запити. Невеликий JavaScript-компонент автодоповнення — з керуванням клавіатурою, данською, англійською й українською мовами та ручним введенням як запасним варіантом — дає сайту поле адреси без власного інтерфейсу. Окремий домен dawakit.dk звертається до команд, які шукають допомогу саме з міграцією.

Факти й результати

56ендпоінтів в описі OpenAPI на запуску в червні 2026 року, і 50 з 50 інтеграційних тестів зелені
1.10.2026DAWA закрито; danadresse.dk на той час працював у продакшені вже з червня
3 домениapi.danadresse.dk, danadresse.dk і dawakit.dk
30–35 мсна повторний запит із відповіддю 304 Not Modified проти 40–65 мс для холодної повної відповіді
p50 82 → 47 мсчас сервера на autocomplete для 500 реальних запитів після оптимізації в жовтні
≈8 год → 12 хвнічна переіндексація після переходу з OFFSET на keyset-пагінацію
4 тарифибезкоштовний із 2 000 запитів на місяць; Basis 71, Pro 223 і Enterprise від 399 крон на місяць при оплаті за рік
2,6 млнадрес входів (adgangsadresser) в індексі (2 619 070 станом на 31.10.2026)

Технології

FastAPI з асинхронною SQLAlchemy 2 на MySQL-сумісній базі, Meilisearch для повнотекстового й префіксного пошуку, Redis для кешу та лімітів, uvicorn за nginx на VPS, який ми адмініструємо самі. GZip і Cache-Control для кожного шляху зі слабкими ETag роблять повторні запити дешевими. Підписаний вебхук GitHub викочує нову версію приблизно за хвилину, а Stripe Billing Meter рахує використання.

Чого ми навчилися

Ми поставили ціль — менше 150 мс на 95-му перцентилі для холодних запитів autocomplete, виміряних з іншого сервера, — і досі її не досягли. Після того як ми прибрали затримку близько 40 мс на кожному виклику Meilisearch і переписали пошук будівель, медіана впала до 94–164 мс, але p95 лишився на рівні 210–484 мс. Межею виявився сервер, а не код: 15 ГБ пошукових даних проти приблизно 8 ГБ сторінкового кешу на мережевому диску. Наступний крок — стиснення індексу, а не нові дрібні правки коду.

Другий урок приніс звіт про помилку від soge.dk, іншого нашого продукту. Autocomplete ігнорував параметр type, тож частина id вела на 404. FastAPI мовчки приймає невідомі параметри, тому неіснуючий фільтр відповідає 200 з усіма рядками. Тепер тест перевіряє, що кожен id з autocomplete відкривається на своєму детальному ендпоінті.

Потрібне щось подібне для вашого бізнесу?

Опишіть задачу у формі. Після безкоштовної розмови про обсяг ми надішлемо план і кошторис та скажемо, які частини цих продуктів можемо використати для вас.

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