Ugrás a tartalomra

Webáruházaknak

Kevesebb visszaküldött csomag: a vásárló már a pénztárnál a helyes címet választja ki. Az Adatka gépelés közben felajánlja a címet, feladás előtt pedig jelzi, ha az irányítószám nem a címhez tartozik, vagy a házszám nincs az adatainkban.

Élő példák

Mi romlik el a pénztárnál

A vásárló a címet sietve, sokszor telefonon gépeli be: ékezet nélkül, rövidítve, az irányítószámot emlékezetből. A rendelés ezzel a címmel megy tovább a futárhoz. Ha az irányítószám más településrészhez tartozik, vagy a házszám nem létezik, a csomag visszajön, a vevőszolgálat telefonál, és a kiszállítás még egyszer pénzbe és időbe kerül.

Mit változtat az Adatka

A pénztárnál: címkiegészítés gépelés közben

A címmező a /suggest végpontot hívja: a vásárló néhány betű után a listából választ.

Az irányítószám, a település és a közterület egységes írásmóddal kerül a rendelésbe; házszámot is ajánl, ahol a forrás tartalmazza.

A rövidítést (u., krt.), az ékezet nélküli bevitelt és a gyakori elgépelést felismeri.

Feladás előtt: címellenőrzés kötegben

A rendelések címeit a /clean végpontnak küldi, hívásonként legfeljebb 1000 sort.

Soronként visszakapja az egységesített címet és a találati szintet: ház, közterület vagy település.

A válasz jelzi, ha a beírt irányítószám nem a címhez tartozik, és ha a házszám nincs az adatainkban. Semmit nem írunk felül némán.

Négy cím a pénztárból — beírva és visszaadva

A válaszok az éles szolgáltatásból valók (2026. október 5.); a címek kitaláltak, nem vásárlói adatok. Bármelyikre kattintva kipróbálhatja az élő demóban.

Élő demó · Források és licencek

Az adatok állapota: Magyar Posta — 2026.09.21-i adatállomány · KSH Helységnévtár — 2025-ös kiadás · OpenStreetMap — 2026.08.16-i kivonat · GeoNames — 2026.08.16-i letöltés · Nemzeti Választási Iroda — 2026.01.16-i állomány

Mit kell bekötni

Két végpont, egyszerű REST API, JSON-válasszal.

Bármely rendszerből hívható, amely HTTP-kérést tud küldeni és JSON-t tud olvasni — külön programkönyvtár nem kell.

Kész bővítményt webáruház-platformhoz jelenleg nem kínálunk. Ha az Ön rendszeréhez ilyenre lenne szüksége, írjon nekünk: info@adatka.hu.

A nyers API-választ az élő demóban az „API-válasz (JSON)” gombbal tekintheti meg; a hívás részletei az API-dokumentációban olvashatók.

GET /suggest?q=nyiregyhaza+dozsa+gy+u+5&limit=5

→ { query, suggestions: [ { postal_code, settlement,
    street, house_number, admin{…}, geo{…},
    meta{ match_level, sources, … } } ] }

POST /clean
{ "records": [ "9022 gyor baross gabor ut 12",
               "pecs kiraly u 999" ] }

→ { results: [ { input, postal_code, settlement,
    street, house_number, …,
    meta{ match_level, postal_not_matched,
          house_not_found } } ] }

Amit nem ígérünk

  • Emelet, ajtó, lépcsőház ellenőrzését: külön mezőben visszaadjuk, de nyilvános forrás híján nem ellenőrizzük.
  • Házszámot mindenhol: ott ajánlunk házszámot, ahol a felhasznált forrás tartalmazza; ahol nem, a válasz közterület szintet ad, és ezt meg is mondja.
  • Hatósági igazolást: az Adatka nem hatósági címnyilvántartás — nyilvános és szerződés alapján használt forrásokat vet össze, és megmutatja, melyikből dolgozott.
  • Számokat a visszaküldött csomagokról: ide csak olyan eredmény kerül, amelyet egy webáruháznál ténylegesen megmértünk — a mérés módjával, időszakával és a webáruház hozzájárulásával.

Hozzáférés

A szolgáltatás jelenleg meghívásos bétaüzemben, díjmentesen érhető el; önkiszolgáló regisztráció még nincs. Kérjen hozzáférést, és felvesszük Önnel a kapcsolatot.

Árak és béta-hozzáférés