API termékkészlet lekérés

A rendszer lehetővé teszi az áruházak tulajdonosai számára, hogy az API elérési URL-eken keresztül személyre szabott termékkészleteket jelenítsenek meg különböző listázó oldalakon, mint például a Facebook Shop, Olcsobbat.hu, Argep.hu, stb.

A termék API adminisztrációs képernyő az adminisztrációs oldalsávból érhető el a Webshop → API menüpont alatt.

Az API adminisztrációs képernyőn felsorolt minden egyes szolgáltatáshoz szükséges, hogy a webáruház tulajdonosok rendelkezzenek fiókkal az adott szolgáltatásnál. Miután létrehoztak egy fiókot egy adott szolgáltatásnál, a rendszerből kimásolhatják és beilleszthetik a megfelelő API-linket, és beilleszthetik azt a szolgáltató oldalán lévő fiókprofiljukba.

A terméklistázási szolgáltatások megkövetelik a bolttulajdonosoktól, hogy fiókjukat meghatározott módon konfigurálják. További információkért kérjük, olvassa el a szolgáltató oldalán található dokumentációt, hogy megértse, hogyan lehet az API-linkeket beilleszteni a rendszerükbe.

A felsorolt termékek URL-címén keresztül történő megadására is szükségük van a sajátos struktúrájukban. Az egyes szolgáltatások termékszerkezetét a rendszer a háttérben kezeli, így a bolt tulajdonosainak nem kell ezzel foglalkozni.

Általános lap

Az általános lapon található beállítási lehetőségek minden szolgáltatás esetében azonosak. Ezért ez a dokumentáció egy szolgáltatás részleteivel foglalkozik, mivel a konfigurációs folyamat minden szolgáltatásnál azonos.

1. A legtöbb termék listázó szolgáltatás egy adott országhoz kapcsolódik. A rendszergazdák az oldal tetején található legördülő menü segítségével szűkíthetők a listát egy adott országra.
2. A termék listázó szolgáltatás neve.
3. Kategóriák - a kategóriák kiválasztása bemenet lehetővé teszi a webáruház tulajdonosok számára, hogy megadják, hogy mely webshop kategóriákból kívánnak termékeket bemutatni a terméklistázási szolgáltatás oldalán. A kategóriák kiválasztásának nincs korlátja.
4. Gyártók - a kategóriák kiválasztása bemenet lehetővé teszi az üzlettulajdonosok számára, hogy megadják, mely gyártótól kívánnak termékeket bemutatni a termék listázó szolgáltatás oldalán. Nincs korlátozás arra vonatkozóan, hogy hány gyártó választható ki.
5. Árazás – kiválasztható, hogy a terméklistázási szolgáltatásban a kiskereskedelmi vagy a nagykereskedelmi termékek jelenjenek meg.
6. Csak megjelölt termékek – bekapcsolása esetén kizárólag azok a termékek kerülnek be a termékfeedbe, amelyeket a webáruház adminisztrációs felületén erre külön megjelöltek
7. URL - ez a mező az automatikusan generált URL-t jeleníti meg. A fenti beállítások bármilyen módosítása automatikusan frissíti a generált URL-t. A generált URL-ben szereplő nyelvjárást (/en, /hu, /sr) az adminisztrációs felület aktuális nyelve határozza meg. Ez határozza meg, hogy a termékek milyen nyelven jelennek meg a termék listázó webhelyen. Miután az összes beállítás megtörtént, az API URL kényelmesen másolható a vágólapra az URL mező végén található Másolás gombra kattintva.
8. A formátum legördülő menüpont lehetővé teszi az ügyfelek számára, hogy kiválasszák, hogy a termékek milyen formátumban kerülnek kiszolgálásra az URL-en keresztül.

A szolgáltatás elérhetőségi országa a szolgáltatás jobb felső sarkában látható, amennyiben nincs konkrét országhoz kötve, a szolgáltatás bárhonnan elérhető.

FONTOS: A nem látható vagy nem rendelhető termékek nem szerepelnek az API URL-címeken keresztül megosztott termékek listáján.

B2B API tokenek lap

A B2B API tokenek funkcióval létrehozható egy olyan API végpont, amely egy adott regisztrált felhasználó számára meghatározott termékek egyedi listáját tartalmazza.

A webáruház kategóriák és gyártók kiválasztásával a rendszergazdák leszűkíthetik, hogy a webáruházban elérhető termékek közül melyeket kell szerepeltetni az API végpontban. Ha nincs kategória vagy gyártó kiválasztva, a végpont a webshopban elérhető összes terméket tartalmazza. Az API végpont emellett további termékadatokat is továbbít, például nettó árat, áfaértéket, paramétereket és deklarációs információkat, mint a nettó súly, bruttó súly vagy az energiaosztály.

A létrehozott felhasználói API tokenek végpontjai részletesebb termékkép-adatokkal bővültek. Az adathalmaz a termék fő képét és a termékhez tartozó további képeket is tartalmazza.

Mivel a végpont egy adott felhasználóhoz van létrehozva, az API URL-en keresztül kiszolgált termékek tartalmazzák a rendszerszintű felhasználói kedvezményeket, amelyeket minden regisztrált felhasználó számára külön-külön lehet beállítani a Felhasználók kezelése → Felhasználók menüpontban, a Kedvezmények lapon. A felhasználó-specifikus kedvezményekről szóló gyors felfrissítésért kérjük, tekintse meg ezt a cikket.

1. Kategóriák - a kategóriák kiválasztása bemenet lehetővé teszi a webáruház tulajdonosok számára, hogy megadják, mely webshop kategóriákból kerüljenek be a termékek. Nincs korlátozva, hogy hány kategóriát lehet kiválasztani.
2. Gyártók - a kategóriák kiválasztása bemenet lehetővé teszi a webáruház-tulajdonosok számára, hogy megadják, mely gyártók termékei kerüljenek be. Nincs korlátozva, hogy hány gyártó választható ki.
3. Raktárak - a raktárak kiválasztásával szűkíthető, hogy mely raktárkészletből elérhető termékek szerepeljenek az API végpontban. Ha nincs raktár megadva, a rendszer nem korlátozza a terméklistát raktár szerint.
4. Felhasználó - az a regisztrált felhasználó, akinek az API végpontot létre kell hozni. Ez a mező lehetővé teszi a felhasználó név vagy e-mail cím szerinti keresését.

A "Mentés" gombra kattintva létrehozza a kiválasztott felhasználó API végpontját a megadott konfigurációval.

A korábban létrehozott API végpontok mindegyike a Felhasználói API tokenek lapon, a Felhasználói API token létrehozása szakasz után található.

1. A regisztrált felhasználó neve és e-mail címe, valamint az ügyfél által használt végpontok száma.
2. A felhasználó által birtokolt végpontok listáját tartalmazó rész a rész jobb felső sarkában található "nyíl" gombbal bővíthető és összezárható.
3. A rendszergazdák kiválaszthatják a végpont formátumát és a formátum választó legördülő menü segítségével, majd a másolás gombra kattintva a létrehozott végpontot a vágólapra másolhatják.
4. Ha egy API végpontra már nincs szükség, egyszerűen törölhető az API URL-bejegyzés végén található piros "kuka" gombra kattintva.
5. Az API URL-cím végén található kék "beállítások" gombra kattintva megjelenik a konfiguráció, amellyel a végpontot létrehozták.

FONTOS: A meglévő API-URL beállításai csak megtekinthetők, de nem szerkeszthetők.