Integracija Shopify Api: Kako deluje, primeri uporabe in kako začeti
A Shopifyjeva integracija API poveže trgovino z drugim sistemom, tako da se lahko izdelki, naročila, stranke, podatki o izpolnitvi naročil ali dogodki pošiljk prenašajo med njima brez ponavljajočega se ročnega vnosa. Običajna izvedba se začne z aplikacijo Shopify ali zasebno operativno storitvijo, uporablja ustrezna dovoljenja API, kjer je praktično, prejema spremembe prek spletnih kavljev ter vključuje zaščitne mehanizme za preverjanje pristnosti, omejitve hitrosti, ponovne poskuse in podvojene dogodke. Za preglednost pošiljk lahko poleg lastnih podatkov Shopify o naročilih in izpolnitvah uporabite tudi API za sledenje, kot je 17TRACK API.
Ustrezna zasnova integracije je odvisna od poslovnega procesa, ki ga želite avtomatizirati. Trgovina, ki potrebuje le stran za sledenje z lastno blagovno znamko, ima drugačne zahteve kot trgovec, ki Shopify sinhronizira z ERP-sistemom, sistemom za upravljanje skladišča, platformo za podporo strankam ali storitvijo za sledenje pri več prevoznikih.
Kaj omogoča integracija API Shopify
Integracija API omogoča dvema sistemoma izmenjavo strukturiranih informacij prek preverjenih zahtev in obvestil o dogodkih. V običajnem poteku e-trgovine Shopify ostane glavni vir resnice za nekatere trgovinske podatke, medtem ko druga platforma upravlja specializiran proces.
- Od Shopifyja do drugega sistema: naročila, informacije o izdelkih, podatki o strankah, zapisi o izpolnitvah in izbrani dogodki naročil se lahko pošljejo v ERP, skladiščno platformo, analitični sistem ali orodje za podporo strankam.
- Od drugega sistema do Shopifyja: posodobitve zaloge, potrditve izpolnitve, sledilne številke in spremembe statusa izpolnitve se lahko zapišejo nazaj v Shopify, če ima integracija potrebna dovoljenja in ciljni potek dela to podpira.
- Dogodki v aplikacijo: spletni kavlji lahko integracijo obvestijo, ko pride do izbranih sprememb, s čimer se zmanjša potreba po nenehnem preverjanju Shopifyja za vsako možno posodobitev.
- Podatki o sledenju za uporabniško izkušnjo: dogodke prevoznikov lahko storitev za sledenje poenoti in jih nato prikaže v poteku preverjanja statusa naročila, sistemu obvestil ali vmesniku za podporo trgovine.
API samodejno ne določi, kateri zapisi naj se prenesejo, kako naj se preslikajo polja ali kaj naj se zgodi, ko se sistema ne ujemata. To so odločitve pri zasnovi integracije. Zanesljiv projekt zato poleg povezave med dvema končnima točkama vključuje poslovna pravila, lastništvo podatkov, spremljanje in postopek obnovitve.
Kako deluje integracija
1. Izberite vzorec integracije
Obstajajo trije običajni vzorci.
- Izvorna aplikacija Shopify: aplikacija, ki jo namesti trgovec, upravlja avtorizacijo in uporablja API-je Shopify za dostop do dovoljenih podatkov trgovine. To je pogosto primerno, kadar bo integracija namenjena več trgovinam.
- Prilagojena aplikacija ali notranja storitev: podjetje izdela integracijo za svojo trgovino ali organizacijo. To omogoča boljši nadzor nad preslikavo polj in operativnimi pravili, vendar mora lastnik še vedno upravljati poverilnice, dovoljenja, spremembe različic in zanesljivost.
- Povezovalnik ali platforma za avtomatizacijo: povezovalnik tretje osebe poveže Shopify z drugo storitvijo prek vnaprej izdelanih potekov dela. To lahko skrajša čas izvedbe, vendar lahko zapletena pravila izpolnitve, veliko število dogodkov ali nenavadni podatkovni modeli zahtevajo razvoj po meri.
Pred izbiro vzorca dokumentirajte vključene sisteme, zapise, ki jih je treba prenesti, smer vsakega toka podatkov in sprejemljivo zakasnitev. Posodobitev sledenja, ki prispe v nekaj minutah, je lahko sprejemljiva za stran, namenjeno strankam, medtem ko sinhronizacija zaloge morda zahteva strožji operativni nadzor.
2. Ustvarite dostop z najmanjšim praktičnim obsegom
Shopify uporablja obsege dostopa API za nadzor nad tem, kaj lahko aplikacija bere ali zapisuje. Integracija naj zahteva le dovoljenja, potrebna za dokumentirane funkcije. Storitev, ki na primer bere informacije o izpolnitvah, naj samodejno ne zahteva dovoljenja za spreminjanje nepovezanih podatkov o izdelkih ali strankah.
Podrobnosti preverjanja pristnosti so odvisne od vrste aplikacije in trenutnih zahtev platforme Shopify. Dokumentacijo Shopify je treba obravnavati kot vir resnice za podprt avtorizacijski tok, ravnanje z žetoni in trenutno različico API. Poverilnice trgovine shranjujte v sistemu za upravljanje skrivnosti, ne v izvorni kodi, preglednicah, shrambi brskalnika ali običajnih konfiguracijskih datotekah.
3. Izberite API in podatkovni model
Shopify ponuja API-je za različne namene. Admin GraphQL API je osrednja možnost za skrbniške podatke trgovine in aplikaciji omogoča zahtevanje polj prek poizvedbenega modela, ki temelji na grafu. Shopify dokumentira tudi druge API-je in vmesnike za posebne primere uporabe, zato je treba pravilno izbiro potrditi v trenutni dokumentaciji in ne predpostavljati na podlagi stare vadnice.
Glavna naloga pri zasnovi je preslikava poslovnih objektov med sistemi. Naročilo Shopify lahko na primer ustreza naročilu v ERP-sistemu, zahtevi za izpolnitev v skladiščnem sistemu in zapisu pošiljke na platformi za sledenje. Ti objekti morda nimajo enakih identifikatorjev ali izrazov za statuse. Shranite izvirne ID-je vsakega sistema in določite stabilno navzkrižno povezavo, namesto da zapise ujemate le po imenu stranke ali skupni vrednosti naročila.
4. Združite spletne kavlje z nadzorovanim branjem prek API
Spletni kavlji so uporabni, kadar se mora sistem odzvati na spremembe. Potek dela lahko začnejo po ustreznem dogodku Shopify, namesto da bi bilo potrebno nenehno preverjanje. Vendar je treba dohodni spletni kavelj običajno obravnavati kot signal za preverjanje in obdelavo spremembe, ne kot dokaz, da je bila vsaka nadaljnja operacija uspešna.
Zanesljiv obdelovalnik preveri zahtevo v skladu z dokumentirano metodo Shopify, zabeleži dogodek, preveri, ali je bil že obdelan, in delo uvrsti v čakalno vrsto, kadar lahko obdelava traja. Delavec lahko nato pridobi zahtevani zapis, uporabi poslovna pravila in zabeleži rezultat. Ta pristop pomaga preprečiti časovne prekoračitve in omogoča varnejše ponovne poskuse.
5. Obravnavajte omejitve, napake in spremembe različic
Klici API lahko ne uspejo zaradi začasnih težav z omrežjem, poteklih poverilnic, neveljavnih podatkov, sprememb dovoljenj, omejevanja ali prehoda na drugo različico API. Integracija mora razlikovati med začasnimi napakami in trajnimi napakami preverjanja. Začasne napake je mogoče ponoviti z naraščajočim zamikom; trajne napake zahtevajo opozorilo, postopek popravka ali ročni pregled.
Omejitve hitrosti so del tehnične zasnove in ne le končna optimizacija. Uporabljajte straničenje, zahtevajte samo potrebna polja, izogibajte se nepotrebnemu preverjanju, razporejajte nenadne sunke zahtev v čakalno vrsto ter spremljajte odzivne kode in zakasnitev obdelave. Pred oceno zmogljivosti za produkcijo preverite trenutne omejitve in vedenje Shopify v uradni dokumentaciji.
Pogosti primeri uporabe integracije API Shopify
Sinhronizacija naročil in izpolnitev
Integracija izpolnitve lahko nova naročila pošlje v skladišče ali 3PL, nato pa potrditve izpolnitve in sledilne številke zapiše nazaj v Shopify. Pomembne odločitve so, kdaj je naročilo upravičeno za izvoz, kako se obravnavajo preklicana ali urejena naročila in kateri sistem po predaji upravlja status pošiljke.
Ne predpostavljajte, da ustvarjeno naročilo pomeni, da je pripravljeno za odpremo. Na pravilo sprostitve lahko vplivajo status plačila, pregled zaradi goljufije, razporeditev zaloge, preverjanje naslova za dostavo in lokacija izpolnitve.
Sinhronizacija zaloge
Integracije zaloge sinhronizirajo razpoložljive količine med Shopifyjem, skladišči, tržnicami in notranjimi sistemi. Dobra zasnova določa vir zaloge, varnostno zalogo, vedenje rezervacij in reševanje sporov. Brez teh pravil lahko sistema prepisujeta drug drugega ali prikazujeta zalogo, ki je že razporejena.
Podpora strankam in iskanje naročil
Platforma za podporo lahko uporablja podatke Shopify, da agentom pomaga najti naročilo, pregledati napredek izpolnitve in določiti naslednje operativno dejanje. To lahko zmanjša preklapljanje med zavihki, vendar je treba podatke o strankah omejiti na primer uporabe za podporo. Pred kopiranjem osebnih podatkov v drugo platformo je treba pregledati zahteve glede hrambe, nadzora dostopa in zasebnosti.
Sledenje pošiljkam in posodobitve po nakupu
Shopify lahko shranjuje informacije o naročilih in izpolnitvah, medtem ko lahko storitev za sledenje zagotavlja dogodke pošiljk posameznih prevoznikov in poenoten prikaz statusa. Ta ločitev je koristna, kadar trgovec sodeluje z več prevozniki ali pošilja v tujino. Integracija mora dosledno preslikati kodo prevoznika, sledilno številko, referenco pošiljke in status dogodka.
Za trgovce, ki želijo že pripravljen potek sledenja Shopify namesto projekta API po meri, je uradna aplikacija 17TRACK Shopify ločena možnost za oceno. Pri aplikaciji po meri preverite dokumentacijo API 17TRACK glede trenutnih zahtev za preverjanje pristnosti, končne točke, sledenje in račun. Aplikacija in API rešujeta povezana, vendar različna izvedbena problema; enega ne predstavljajte kot nadomestilo za drugega, ne da bi preizkusili zahtevani potek dela.
Praktičen načrt za začetek
- Rezultat opišite s poslovnimi izrazi. Na primer: »Plačana naročila pošljite v skladišče v določenem časovnem okviru storitve« ali »Strankam po dodelitvi sledilne številke prikažite napredek pošiljke.«
- Naštejte sisteme in lastnike. Določite, kdo je odgovoren za izdelke, zalogo, naročila, izpolnitve, dogodke sledenja in obvestila strankam.
- Ustvarite preslikavo polj. Vključite ID-je, časovne žige, vrednosti statusov, naslove, količine, kode prevoznikov, sledilne številke in polja napak. Označite obvezna, izbirna, samo za branje in pretvorjena polja.
- Potrdite trenutno dokumentacijo. Preverite različico API Shopify, metodo preverjanja pristnosti, obsege dostopa, zahteve spletnih kavljev, vedenje straničenja in omejitve hitrosti. Preverite ustrezno dokumentacijo vsake zunanje platforme.
- Izdelajte omejen dokaz koncepta. Začnite z majhno testno trgovino ali nadzorovanim naborom podatkov. Pred dodajanjem vseh vrst objektov preverite preverjanje pristnosti, eno pot branja, eno pot pisanja, če je potrebna, in en potek dela na podlagi dogodkov.
- Dodajte idempotentnost in usklajevanje. Ponovljen spletni kavelj ali ponovni poskus ne sme ustvariti podvojenih pošiljk, sporočil strankam ali prilagoditev zaloge. Načrtujte preverjanja usklajevanja za iskanje spregledanih ali zavrnjenih zapisov.
- Preizkusite operativne izjeme. Vključite preklicana naročila, spremenjene naslove, deljene pošiljke, delne izpolnitve, manjkajoče sledilne številke, neveljavne kode prevoznikov, podvojene dogodke, omejevanje API, potekle poverilnice in zapoznele posodobitve prevoznikov.
- Objavite z nadzorom. Spremljajte uspešne in neuspešne dogodke, starost čakalne vrste, napake odzivov API, čas obdelave in zapise, ki zahtevajo ročno ukrepanje. Določite, kdo prejema opozorila in kako se napake znova predvajajo.
Kdaj uporabiti povezovalnik, aplikacijo po meri ali API za sledenje
| Možnost | Običajno primerna za | Glavna preverjanja pred izbiro |
|---|---|---|
| Povezovalnik ali orodje za avtomatizacijo | Standardne poteke dela z malo prilagajanja | Podprti objekti, zakasnitve dogodkov, obravnava napak, omejitve opravil in hramba podatkov |
| Prilagojena aplikacija ali storitev Shopify | Posebna poslovna pravila, več sistemov ali nadzorovani notranji procesi | Odgovornost za razvoj, varnost, spremljanje, vzdrževanje API in skupni operativni stroški |
| API za sledenje | Prilagojena izkušnja po nakupu ali preglednost pošiljk | Zahteve prevoznikov in regij, življenjski cikel sledenja, vedenje posodobitev, omejitve in komercialni pogoji |
Povezovalnik ni samodejno preprostejši, če potek dela zahteva prilagojene ponovne poskuse ali zapleteno usklajevanje. Prav tako integracija po meri ni samodejno boljša, če zahteve že izpolnjuje standardna in dobro podprta aplikacija. Najbolj utemeljena izbira je najmanjša izvedba, ki izpolnjuje zahteve glede podatkov, zanesljivosti, varnosti in delovanja.
Kontrolni seznam varnosti in zanesljivosti
- Uporabljajte obsege dostopa z najmanjšimi privilegiji in jih ob spremembi integracije ponovno preglejte.
- Žetone in skrivnosti hranite zunaj kode aplikacije ter jih menjajte prek nadzorovanega postopka.
- Preverjajte pristnost spletnih kavljev v skladu z dokumentacijo platforme.
- Šifrirajte podatke med prenosom ter omejite skrbniški dostop do dnevnikov in zapisov strank.
- Uporabljajte idempotentno obdelavo, da ponovni poskusi ne ponavljajo stranskih učinkov.
- Za revizijo in usklajevanje shranjujte ID-je izvornih sistemov in časovne žige dogodkov.
- Ločite testne in produkcijske poverilnice ter se pri občasnem testiranju izogibajte uporabi živih podatkov strank.
- Pred kopiranjem osebnih podatkov v drugo storitev preglejte obveznosti glede zasebnosti, hrambe in brisanja.
- Spremljajte različice API in načrtujte nadgradnjo, preden se podpora za različico spremeni.
Pogosta vprašanja
Ali je integracija API Shopify enaka namestitvi aplikacije Shopify?
Ne. Aplikacija Shopify lahko uporablja API-je Shopify, vendar je namestitev aplikacije dejanje uvedbe, namenjeno trgovcu. Integracija API je širša povezava med Shopifyjem in drugim sistemom. Izvedena je lahko prek javne aplikacije, prilagojene aplikacije, notranje storitve ali povezovalnika.
Kateri API Shopify naj uporabim?
API izberite glede na podatke in potek dela, nato pa trenutno priporočilo potrdite v dokumentaciji Shopify. Za skrbniške podatke trgovine je Admin GraphQL API običajna možnost, vendar je treba za natančen primer uporabe preveriti preverjanje pristnosti, dovoljenja, razpoložljivost objektov in podporo različice.
Ali lahko Shopify sam zagotovi posodobitve sledenja prevoznikov?
Shopify lahko shranjuje informacije o izpolnitvah in sledenju, vendar je popolna izkušnja sledenja odvisna od tega, kako so dogodki pošiljk pridobljeni, poenoteni, prikazani in posredovani. Potek dela z več prevozniki ali mednarodni potek dela lahko zahteva namensko storitev za sledenje ali drug integracijski sloj.
Ali naj uporabim spletne kavlje ali preverjanje?
Spletni kavlji so na splošno uporabni za odzivanje na spremembe, nadzorovano branje prek API pa za preverjanje, usklajevanje in obnovitev. Produkcijske integracije običajno uporabljajo oboje, namesto da bi se zanašale izključno na eno metodo.
Koliko časa traja integracija API Shopify?
Ni enega zanesljivega časovnega okvira. Osnovni povezovalnik je mogoče nastaviti hitro, medtem ko integracija po meri, ki vključuje zalogo, izpolnitve, podatke strank, več prevoznikov in usklajevanje, zahteva več načrtovanja in testiranja. Število sistemov, pravila izjem, varnostni pregled in nadzor uvedbe so boljši napovedniki kot sama povezava s Shopifyjem.
