Elkészült az Eshop-gyorsan API új, 2.0-s verziója.

Az új API egyszerűbbé teszi az Eshop-gyorsan rendszeréhez kapcsolódó külső rendszerek integrációját: mostantól elég egyetlen URL-címet használni. Az új környezetben a fejlesztők gyorsabban és kényelmesebben tudnak dolgozni, ráadásul a 2.0-s verzióban már több olyan hibajavítás is elérhető, amelyek korábban kellemetlenséget okozhattak.

A technikai dokumentáció és minden további információ itt érhető el:
https://api.bohemiasoft.com/docs

Fontos változás, hogy az API 1.0-s verzióját a jövőben már nem fejlesztjük és nem frissítjük tovább. A meglévő integrációk természetesen továbbra is korlátozás nélkül használhatják ezt a verziót.

Minden jövőbeni módosítás, fejlesztés és új funkció azonban már kizárólag az API 2.0-ban lesz elérhető.

Az Eshop-gyorsan egy dinamikusan fejlődő e-kereskedelmi platform, amely lehetővé teszi fejlesztők számára, hogy saját alkalmazásokat hozzanak létre és integráljanak a rendszerbe. Ebben a bejegyzésben lépésről lépésre bemutatjuk, hogyan kezdheted el az alkalmazásfejlesztést az Eshop-gyorsan platformhoz.

Regisztráció a Marketplace-en

Első lépésként regisztrálnod kell a Marketplace felületén, közvetlenül itt: https://marketplace.eshop-gyorsan.hu/register. A regisztráció után több alkalmazást is létrehozhatsz egyetlen fiók alatt.

Fontos: Ha az alkalmazásodat több nyelvi mutációban szeretnéd elérhetővé tenni (jelenleg a magyar, cseh és szlovák nyelveket támogatjuk), akkor minden nyelvi mutációhoz külön alkalmazást kell létrehoznod.

Alkalmazás létrehozása

Az alkalmazás létrehozásának folyamata részletesen megtalálható a dokumentációban, itt: https://marketplace.eshop-gyorsan.hu/doc. Itt megtalálod az összes szükséges információt az alkalmazásod regisztrálásához és beállításához.

API Kommunikáció az Eshop-gyorsan rendszerrel

Az alkalmazás és az e-shop közötti kommunikációhoz használd az Eshop-gyorsan API-ját, aminek dokumentációját itt találod: https://webareal.docs.apiary.io/#.

Itt megtalálod az összes elérhető API végpontot és azok használatát.

Webhookok használata

Ha alkalmazásodnak szüksége van webhookokra, tekintsd meg az Eshop-gyorsan webhook dokumentációját: https://helpdesk.webareal.cz/article-base/webareal-webhook-api-dokumentace/.

Tesztelési lehetőség

Az alkalmazásod teszteléséhez ingyenesen létrehozhatsz egy e-shopot 14 napra (kérésre ez meghosszabbítható) a következő oldalon: https://eshop-gyorsan.hu/.

Ahhoz, hogy a még nem jóváhagyott alkalmazásod látható legyen a teszt e-shopodban, generálnod kell egy fejlesztői kulcsot a Marketplace adminisztrációs felületén, és be kell illesztened azt a teszt webshop admin felületén.

Az alkalmazás jóváhagyása

Az alkalmazás fejlesztésének befejezése után, ha szeretnéd elérhetővé tenni más webshop tulajdonosoknak is, kérned kell az alkalmazás jóváhagyását a Marketplace adminisztrációs felületén,  az “Ellenőrzés kérése” gombra kattintva.

Az alkalmazások működési elve

Az alábbiakban részletezzük az alkalmazások működési elvét:

1. Alkalmazás létrehozása a Marketplace adminisztrációjában: Itt meg kell adnod az alkalmazásod telepítési URL-jét. Lásd: https://marketplace.eshop-gyorsan.hu/doc/getting-started.
2. Telepítési folyamat: Amikor egy e-shop tulajdonos a telepítésre kattint, az általad megadott URL-t hívjuk meg. A kérés tartalmazza az e-shop információit (pl. e-shop kód, e-mail cím). Neked létre kell hoznod egy scriptet, amely fogadja és elmenti ezeket az adatokat, majd 200-as HTTP státusszal válaszol (“done”). Részletek: https://marketplace.eshop-gyorsan.hu/doc/install-process.
3. További kérések és funkciók: Ezután további kéréseket indíthatsz az alkalmazásod funkcióinak létrehozásához.
   • Adatok küldése rendelésekről: Az e-shop tulajdonos az adminisztrációban rákattinthat a “Adatok küldése a [ALKALMAZÁS NEVE]-nak” gombra, amely elküldi a rendelés adatait a scriptednek (nem webhookon keresztül). Lásd: https://marketplace.eshop-gyorsan.hu/doc/button.
   • Átvételi pont kiválasztása térképen: Ha az alkalmazásodban szükség van egy térképre az átvételi pontok kiválasztásához, használd ezt: https://marketplace.eshop-gyorsan.hu/doc/delivery.

Reméljük, hogy ezek az információk segítséget nyújtanak a bővítmények fejlesztésében az Eshop-gyorsan platformhoz.

Sok sikert kívánunk a fejlesztéshez!

Ha kérdésed merülne fel, vagy segítségre van szükséged, fordulj hozzánk bizalommal.

Kezdj neki még ma, és hozz létre fantasztikus alkalmazásokat az Eshop-gyorsan közösség számára!