Ugrás a tartalomra

Fejlesztési napló

Itt dátummal rögzítjük, mi változott az Adatkában: az API válaszaiban, az adatforrásokban, a feltételekben és a weboldalon.

Mielőtt olvasni kezd

  1. A napló tájékoztató jellegű. A szolgáltatás feltételeit az ÁSZF tartalmazza; ha a napló eltér az ÁSZF-től, az ÁSZF az irányadó.
  2. Minden bejegyzés a saját dátuma szerinti állapotot írja le. Azóta a működés változhatott: a mostani állapotot az API-dokumentáció és a hatályos feltételek mutatják.
  3. Az Adatka nyilvánosan közzétett, illetve nyílt licencű adatforrásokra épül; ezekben hiányok és hibák is előfordulnak. A találat nem hatósági igazolás (ÁSZF 4. pont).

A bejegyzéseket Az őszinte tájékoztatás szabályai szerint írjuk és javítjuk: közzétett bejegyzést nem írunk át (2. pont).

Bejegyzések

Új „Kapcsolat” oldal; átalakult a fejléc menüje

· Weboldal · Nem igényel teendőt

A „Kapcsolat” oldal megmutatja, hová írhat kérdéssel, hibajelzéssel vagy egyedi ajánlattal. A fejlécből kikerült a „Megoldások” menüpont: a „Webáruházaknak” oldal és a főoldal „Kinek hasznos” része mostantól a „Termékek” menü „Felhasználási területek” oszlopában érhető el; az „API” menüpont neve „API-dokumentáció” lett.

Módosult az Akadálymentesítési nyilatkozat

· Feltételek · Nem igényel teendőt

Az Akadálymentesítési nyilatkozat hatályát kiterjesztettük a Fejlesztési naplóra, „Az őszinte tájékoztatás szabályai” oldalra és a „Kapcsolat” oldalra; a 4. pontban pontosítottuk a nyelvválasztó leírását, a 6. pontot pedig kiegészítettük e három oldal ellenőrzésével.

Megjelent a Fejlesztési napló és „Az őszinte tájékoztatás szabályai” oldal

· Weboldal · Nem igényel teendőt

Ebben a naplóban dátummal rögzítjük, mi változott az Adatkában. Az őszinte tájékoztatás szabályai leírják, hogyan tájékoztatjuk Önt; szó van bennük a dátumokról, a javításokról, a korlátokról, a forrásokról és a hivatkozásokról. A korábbi bejegyzéseket utólag, a napló megjelenésekor írtuk: a weboldal indulása óta történt, általunk ellenőrzött fontosabb változásokat rögzítik.

Új szöveg az Árak oldalon

· Weboldal · Nem igényel teendőt

Az Árak oldalon mostantól ez olvasható: „Árakat addig nem teszünk közzé, amíg nem látszanak pontosan a használati dimenziók, és nem tudunk kiszámítható, hosszabb távon is stabil díjszabást kialakítani.”

Az ÁSZF lényeges módosítása: számszerű keret a kulcs nélküli használatra

· Feltételek · Teendőt igényel

Közzétettük az ÁSZF lényeges módosítását: 2026. november 5-től számszerű keret vonatkozik a kulcs nélküli használatra (5. pont); addig a visszaélés elleni fék érvényes. A módosítás leírása az ÁSZF új szövegében olvasható, a számok pedig az API-dokumentáció „Korlátok” részében.

Teendő: ha kulcs nélkül, nagy forgalommal hívja az API-t, kérjen API-kulcsot (lásd a „Korlátok a kulcs nélküli használatra” bejegyzést).

Településrészek a keresésben

· API · Nem igényel teendőt

A keresés felismeri a városrészeket, lakótelepeket és más településrészeket (például „Békásmegyer”, „Jereván-lakótelep Sopron”). Új találati szint: settlement_part; új jelzés: settlement_part_not_matched (lásd: Találati szintek és jelzések). Forrás: OpenStreetMap és KSH Helységnévtár.

Korlátok a kulcs nélküli használatra

· API · Teendőt igényel

Kulcs nélküli használatnál a szolgáltatás mostantól korlátozza a visszaélésszerű lekérdezéseket, 2026. november 5-től pedig számszerű keret is vonatkozik erre a használatra. Kulcs nélküli hívásnál a 429-es válasz törzse megmondja, melyik korlátról van szó (lásd: Korlátok).

Teendő: ha kulcs nélkül, nagy forgalommal hívja az API-t, kérjen API-kulcsot.

Megjelent az API-dokumentáció

· Weboldal · Nem igényel teendőt

Az API-dokumentáció magyarul írja le a végpontokat, a címobjektum mezőit, a találati szinteket, a hibakódokat és a korlátokat, curl- és Python-példákkal.

Új találati szint: a házszám ismert, de koordináta nincs hozzá

· API · Nem igényel teendőt

Forrás: Nemzeti Választási Iroda, Körzetállomány · Adatállomány: 2026. január 16.

Ha a házszám szerepel a Nemzeti Választási Iroda címállományában, de saját koordinátánk nincs hozzá, a válaszban a match_level értéke house_exists, a meta.house_exists jelzés pedig megadja a forrást és a kivonat dátumát. A koordináta pontosságát ilyenkor a geo.precision mutatja (lásd: Találati szintek és jelzések).

Új jelzés: postal_alias — a postal_code mezőben nem mindig a beírt irányítószám áll

· API · Nem igényel teendőt

Ha a beírt irányítószámot egy másik forrás a településhez rendeli, de a Magyar Posta szerint a település irányítószáma más, a válasz postal_code mezőjében a Magyar Posta szerinti irányítószám áll, a beírt érték pedig a meta.postal_alias jelzésben (például „csömend 8700” → postal_code: "8703", meta.postal_alias: "8700"; lásd: Találati szintek és jelzések). Korábban ilyenkor is a beírt irányítószám állt a postal_code mezőben.

Új adatforrás: a Magyar Posta irányítószám- és közterületadatai

· Adatok · Nem igényel teendőt

Forrás: Magyar Posta Partner Extra · Adatállomány: 2026. szeptember 21.

A keresés a Magyar Posta Partner Extra 2026. szeptember 21-i adatállományának irányítószám- és közterületadatait is használja. Ha a találathoz ez a forrás is hozzájárult, a válasz forráslistájában (meta.sources) a Magyar Posta is szerepel.

Mire való a napló — és mire nem

Miért vezetjük?

Hogy lássa, mi változott és mikor — és ne a saját rendszerében vegye észre először. Ha beépítette az API-t, itt megnézheti, kell-e tennie valamit.

Mit talál benne?

  1. október 23. óta az alábbi változások mindegyikét, a korábbiak közül a fontosabbakat:
  • Az API válaszainak változásait: új, átnevezett vagy megszűnő mezőt, megváltozott értéket.
  • Az adatforrások frissítéseit: melyik forrás, milyen dátumú állománnyal.
  • Az ÁSZF és a többi jogi oldal módosításait egymondatos összefoglalóval — a teljes szöveg az adott jogi oldalon olvasható.
  • A weboldal fontosabb változásait.

Mit jelentenek a címkék?

  • Teendőt igényel — a változás miatt az API-t hívó rendszerben módosítani kell, például azért, mert egy mező megszűnik vagy új nevet kap; a bejegyzésből kiderül, kit érint a teendő.
  • Nem igényel teendőt — a meglévő bekötés változtatás nélkül működik tovább.

Mire nem való?

Nem szerződés, és nem módosítja az ÁSZF-et; a feltételek módosításáról az ÁSZF 8. pontja szerint tájékoztatjuk, a napló ezt nem helyettesíti. A felelősségről az ÁSZF 7. pontja rendelkezik.

Az Adatka válasza nem igazolja, hogy egy cím helyes vagy létezik, és ha egy címre nincs találat, az sem bizonyítja, hogy a cím nem létezik (ÁSZF 4. pont). Ne építsen olyan folyamatot, amely kizárólag egy Adatka-válasz alapján dönt — például letilt egy rendelést —, hanem hagyjon lehetőséget kézi ellenőrzésre.

Nem a mostani állapot leírása: egy régebbi bejegyzés a saját dátuma szerinti állapotot írja le.

Ha hibát talál, írjon az info@adatka.hu címre.

A napló Atom-hírcsatornaként is elérhető.