Első lépések
Szeretnénk megismerni a szolgáltatásodat, így ha integráció fejlesztése mellett döntesz, első lépésként vedd fel velünk a kapcsolatot az app@unas.hu email címen! Az alábbiakban látsz egy listát, amiben azok az adatok vannak, amelyek szükségesek egy integráció végleges élesítéséhez. Tudjuk, hogy az első szakaszban még nem mindegyik áll rendelkezésedre, mégis kérjük minél több információt küldj el nekünk a szolgáltatásról, alkalmazásról amit illeszteni szeretnél! Mindenképpen írd le, hogy milyen célt szolgál a fejlesztés, milyen menüpontban jelenne meg az Unas admin felületén (integráció jellege)! Tájékoztass a szolgáltatás igénybevételének feltételeiről is, mutasd meg milyen költséggel, milyen csomagokat vehetnek majd igénybe az előfizetők.
Ha még nincs fejlesztői webáruházad, párhuzamosan nyiss egy tesztáruházat, lehetőleg olyan néven, ami utal az integrálandó szolgáltatásra! Küldd el nekünk a nevét és átsoroljuk fejlesztői státuszúra, amit aztán használhatsz a fejlesztés ideje alatt, illetve a későbbiekben az éles üzemben is az esetleges hibajavítások, optimalizálások érdekében! Ebbe a webshopba fogjuk engedélyezni a demo integrációt is, ami konkrét fájlokkal szolgál segítségül a struktúra megismeréséhez, illetve ebben a webshopban jelenik meg a kialakítás szakaszában a saját fejlesztésed is.
Az elküldött bemutatkozás után elbíráljuk, hogy az integráció bekerülhet-e az Unas rendszerbe és tájékoztatunk a további feltételekről. Pozitív elbírálás esetén megkezdődhet a fejlesztés. Természetesen a fenti email címen technikai kérdéseket is feltehetsz, ha valami nem lenne egyértelmű jelen dokumentációban vagy a demo integráció forráskódjában.
Ezeket az információkat kell elküldened nekünk
- Integráció neve - Ez jelenik majd meg a telepítés során és az integráció saját oldalán is.
- Rövid leírása - A telepítés előtt a webáruház tulajdonos egy rövidebb leírást olvashat szolgáltatásodról, az integrációról.
- Részletes leírása - A telepítés során az áruház üzemeltető egy teljes leírást olvashat szolgáltatásodról, az integrációról. Ebben igyekezz minden olyan információt leírni, ami a szolgáltatás igénybevételéhez nélkülözhetetlen. Ez lehet akár formázott HTML tartalom is.
- Alkalmazás logója - 952x400px, webp formátumban. Ez jelenik meg a telepítés során, illetve minden promóciós anyagban.
- Install URL - Ide küldjük majd a telepítési kéréseket a Telepítés folyamata részben részletezett formában. SSL használata kötelező, "https" URL-t várunk.
- Uninstall URL - Ide küldjük majd a törlési kéréseket, a Törlés folyamata részben olvashatsz erről bővebben. SSL használata kötelező, "https" URL-t várunk.
- Start URL - Ez az alkalmazás kezdőoldala, GET paramétereket használunk az azonosítás és a validáció érdekében (Telepítés folyamata részben erről is olvashatsz), az URL-ben hash (pl.:
https://app-123456.com/app#hash) nem használható. SSL használata kötelező, "https" URL-t várunk.
- Webhook URL - Webáruház által küldendő webhook-ok fogadó URL-je az integráció számára.
- Használni kívánt API végpontok listája - A generált API kulcshoz biztonsági és adatvédelmi okokból csak a valóban szükséges végpontokat engedélyezzük számodra. Az API dokumentációban megtalálod a jelenleg elérhető összes végpontot és azok működését, példákat.
- Használt IP címek, IP tartományok - Biztonsági okokból csak ezekről fogadunk el kéréseket. Csak IPv4 címeket várunk.
- Integráció jellege - Jelenleg ezek közül választhatsz, akár többet is:
- Szállítási mód
- Fizetési mód
- Árösszehasonlító export, Feed
- Chat a látogatóval
- Piactér
- Ellenőrző, minősítő rendszer
- Számlázás, ügyvitel
- Hírlevél küldés
- Marketing rendszer
- Statisztika
- Kiszervezett logisztika
- Dropshipping, nagyker kapcsolat
- Külső ÁSZF megoldások
- Egyéb
- Integráció típusa - Kétféle lehet: Embedded, azaz az admin felületbe integrált, ilyen esetben az áruház üzemeltető nem hagyja el az admin felületet (ajánlott). Redirected: ebben az esetben az adminisztrátort átirányítjuk a megadott URL-re, így elhagyja az admin felüeltet (nem ajánlott).
- Előfizetési csomagok - Erről bővebben itt olvashatsz. Később is megadható.
- Tesztáruházad neve - Fejlesztési és tesztelési idő alatt csak ebben a teszt áruházban engedélyezzük az alkalmazásodat.
Ezeket küldjük mi neked
- AppID - Integráció azonosítója.
- Secret - Titkos kulcs, ezt a hmac előállításához kell használnod.
- AppURL - Az alkalmazás URL-je az Unas admin felületén, publikálás előtt csak ezen a közvetlen URL-en éred azt el, illetve ide kell küldened majd az API kulcs kéréseket is.
