Hozzáférés a Mergado demókörnyezethez#
Ez az útmutató végigvezet a saját Mergado Store bővítményed létrehozásán, a Mergado API-hoz való csatlakozáson és a biztonságos tesztelésen közvetlenül a Mergadóban, fizetés nélkül. A Mergado lehetővé teszi a fejlesztők számára, hogy saját integrációkat („bővítményeket") hozzanak létre, amelyek kibővítik az editor funkcióit vagy kommunikálnak az API-val. Hivatalos „demókörnyezet" előre feltöltött adatokkal nem létezik — ehelyett néhány lépésben elkészítheted a saját tesztprojektedet.
Lépésről lépésre#
1) Hozz létre fiókot a Mergadóban#
Ha még nincs fiókod, regisztrálj az app.mergado.com oldalon.
2) Hozd létre a saját bővítményedet#
- Nyisd meg: https://app.mergado.com/developers/create-app/
- Töltsd ki a bővítmény alapadatait.
- A létrehozás után megkapod a hozzáférési adatokat (pontosabban hozzáférést azokhoz az entitásokhoz, amelyeknél a bővítmény be van kapcsolva).
3) Készítsd elő a tesztprojektet (ha a bővítményed projektszinten működik)#
- A Mergadóban hozz létre egy új projektet teszteléshez.
- Tölts fel egy teszt feedet – elég egy kis feed néhány termékkel.
- A projekt beállításaiban kapcsold a projektet tesztüzemmódba, hogy a tesztelés ingyenes legyen.
4) Kapcsold be a bővítményt a projektben#
A projekt beállításaiban engedélyezd (kapcsold be) a bővítményedet. Ezzel hozzáférést kap azokhoz az entitásokhoz (feedekhez/projektekhez), amelyeket olvashat és szerkeszthet.
5) Autorizáció és API-hívások#
- Az autorizáció menete: https://mergado.github.io/docs/api/authorization.html
- API-dokumentáció: https://mergado.docs.apiary.io/#
Figyelj az API-verzióra: A használt verzió befolyásolja az endpointok viselkedését. Ha a verzió nem egyezik, a működés eltérhet a dokumentációtól.
Tippek a hatékony teszteléshez#
- Nem létezik központi demó webáruház – minden fejlesztő saját tesztprojektet készít.
- A tesztüzemmód biztosítja, hogy a tesztelésért ne kelljen fizetned.
- Ha a bővítményed projektszintű hozzáférést igényel, engedélyezd az adott projektben.
- Gyors tesztekhez elegendő egy kis feed néhány termékkel – nem szükséges éles adatokat feltölteni.
- Használj külön tesztfiókot/projektet az integrációkhoz, hogy ne nyúlj hozzá az éles adatokhoz.
GYIK#
Létezik hivatalos demókörnyezet adatokkal? Nem. Központi demóadatok nem állnak rendelkezésre. Hozd létre a saját tesztprojektedet a Mergadóban.
Hol regisztrálhatok a Mergadóba? Az app.mergado.com oldalon.
Hol hozhatom létre a bővítményemet? A https://app.mergado.com/developers/create-app/ címen. Az alapadatok kitöltése után hozzáférést kapsz azokhoz az entitásokhoz, amelyeknél a bővítmény be van kapcsolva.
Hogyan tesztelhetek díjmentesen? A projekt beállításaiban kapcsold be a tesztüzemmódot.
Szükségem van projektre, ha a bővítményem projektekkel dolgozik? Igen. Hozz létre egy tesztprojektet, tölts fel egy kis feedet, és a bővítményt a projektben engedélyezd.
Hogyan adhatok a bővítménynek hozzáférést a projekt adataihoz? A projekt beállításaiban kapcsold be a bővítményt. Ezzel hozzáférést kap a feedekhez/projektekhez, amelyeket olvashat/szerkeszthet.
Hol találom az API-autorizáció leírását? A dokumentációban: https://mergado.github.io/docs/api/authorization.html.
Hol van a teljes API-dokumentáció? Az https://mergado.docs.apiary.io/# címen.
Az endpoint másképp viselkedik, mint a dokumentációban. Mi a teendő? Ellenőrizd az API-verziót. Az endpointok viselkedése verziókezelve van, és eltérő verzió eltérő működést eredményezhet.
Mekkora feedet használjak teszteléshez? Elég egy kis feed néhány termékkel – ideális a gyors iterációhoz.
Hogyan védhetem meg az éles adatokat fejlesztés közben? Használj külön tesztfiókot/projektet, hogy a változtatások ne érintsék az éles rendszert.