JSON áttöltő áttekintés

Bevezetés

A JSON áttöltő segítségével teljes adatbázis-szinkronizálást lehet végrehajtani a saját rendszer és az Ingatlanok.hu között.

A tesztrendszerhez való hozzáféréshez kérjük, érdeklődjön az api@ingatlanok.hu címen.

Formátum

A JSON fájlok felfoghatóak konténereknek, ahol tetszőleges számú és típusú objektum szerepelhet bármilyen sorrendben egy listában.

Példa

[
    {
        "type": "link",
        "url": "https://ingatlanoldalam.tld/export/ingatlanok.hu/objects1.json"
    },
    {
        "type": "property",
        "property": {

        }
        "location": {

        }
    },
    {
        "type": "seller",
        "seller": {

        }
    }
]

Az adatoknak minden esetben UTF-8 kódolásúnak kell lenniük.

Megjegyzés

A megadott példákban nem valós azonosítók vannak.

Opcionális elemeknél az alapértelmezett értékek félkövérrel jelennek meg a leírásban.

Típusdefiníciók:

"string(1-40)": legalább 1, legfeljebb 40 karakteres szöveg
"string(255)": legfeljebb 255 karakteres szöveg
"uint(8)": legfeljebb 8 számjegyű pozitív egész szám
"uint{50-500}": legalább 50, legfeljebb 500 értékű pozitív egész szám
"double{15-24}": legalább 15, legfeljebb 24 értékű lebegőpontos szám
"decimal(18, 2)": legfeljebb 18 számjegyű decimális szám, 2 tizedesjegy pontossággal
"datetime": dátum (ISO 8601)
"object": JSON objektum

Áttöltési logika

A sikeres és hatékony szinkronizálása alapfeltétele, hogy minden ingatlan, értékesítő és kép objektum egyedileg beazonosítható legyen. Erre használatos az objektumokban jelen levő kötelező transfer_id mező. A létrehozás, módosítás és törlés mind ezen mező alapján történik.

Figyelem

Képek esetében a kép mint bináris tartalom feldolgozása (azaz a képfeltöltés) csak egyszer történik meg (amikor az egyedi azonosító először megjelenik az adatbázisban), a kép URL megváltozását nem veszi figyelembe a rendszer!

Az objektumok sorrendje tetszőleges a konténerekben, a rendszer a dependenciák figyelembe vételével dolgozza fel az adatokat. Azaz például egy értékesítőnek nem kell előrébb szerepelnie a listában, mint a rá hivatkozó ingatlannak.

Korlátozások

A JSON fájlok (konténerek) mérete nem haladhatja meg a 100 MB-ot.