Shopify Flow i GraphQL Admin API

Flow koristi Shopify GraphQL Admin API za izgradnju automatizacija i integracija koje proširuju i poboljšavaju Shopify admin. Flow koristi verziju 2026-01 API-ja za procenu uslova i promenljivih u tokovima posla, kao i za preduzimanje akcija u vašoj Shopify prodavnici. Pošto Flow pristupa podacima o prodavnici pozivanjem API-ja, sa platforme Flow imate pristup skoro svim poljima dostupnim u API-ju.

Budući da Shopify izdaje nove API verzije svaka 3 meseca, neki tokovi posla će možda morati da se ažuriraju kada se polja promene ili zastare.

Korišćenje interfejsa GraphQL Admin API u tokovima posla

Većina radnji u aplikaciji Flow koristi GraphQL Admin API za unošenje promena u Shopify prodavnici. Na primer, radnja Dodaj oznake porudžbine koristi mutaciju tagsAdd. Radnja Pošalji Admin API zahtev može da koristi većinu mutacija, uključujući i one koje još uvek nisu dostupne kao radnje u aplikaciji Flow.

Prilikom kreiranja tokova posla, često ćete nailaziti na imena polja i opise koji se zasnivaju na sintaksi za GraphQL Admin API. Na primer, da biste odredili ukupnu količinu neke varijante za prodaju u toku posla, upotrebili biste promenljivu variants_item.inventoryQuantity. Drugi primer je određivanje lokacije na kojoj se kupac prijavio na vaš imejl bilten, za šta biste koristili promenljivu emailSubscriptionMethod.

Nije neophodno da odlično poznajete API da biste kreirali tokove posla u aplikaciji Flow, ali osnovno razumevanje imena promenljivih i njihovih definicija može da vam pomogne u izradi željene logike za tok posla. Na primer, poznavanje razlike između parametara displayName (ime za prikaz) i firstName (ime) kupca omogućava toku posla da pristupi pravim podacima na osnovu vaše namene. Definicije su priložene uz svaku promenljivu tokom izrade toka posla, a možete da kliknete na da biste saznali više o svakoj promenljivoj ili definiciji.

Podaci prodavnice i GraphQL Admin API

Tokovi posla koriste podatke iz vaše prodavnice u uslovima i radnjama. Flow pristupa podacima prodavnice putem interfejsa GraphQL Admin API, što znači da imate pristup gotovo svim poljima u API-ju. Ako radnja nema neophodne podatke koje prosleđuje okidač ili radnja Preuzmi podatke, tok posla se ne izvršava i prikazuje se poruka o grešci.

Na primer, tok posla se pokreće okidačem Kupac je kreiran i uvozi podatke o kupcu u tok posla. Ako nakon tog okidača sledi radnja Dodaj oznake porudžbine koja zahteva podatke o porudžbini, a ne podatke o kupcu, rezultat toka posla biće greška zbog nedostatka podataka.

Možda će biti potrebno da pregledate podatke ili proverite dokumentaciju za API da biste razumeli šta generiše API i šta se koristi u aplikaciji Flow, kao i da biste se uverili da tok posla daje očekivane rezultate.

Argumenti polja i GraphQL Admin API

Za neka polja za GraphQL Admin API potrebni su argumenti, odnosno dodatni parametri kojima se sužava opseg dobijenih podataka. Na primer, polju product.inCollection je potreban argument kolekcije id da bi znalo koju kolekciju da proveri. Bez njega polje ne može da vrati rezultat.

U aplikaciji Flow iz ovih polja možete da kreirate promenljive tako što ćete uneti potrebnu vrednost argumenta koju zatim možete da upotrebite u toku posla. Možete i da dodelite prilagođeno ime promenljivoj radi lakšeg snalaženja u sledećim koracima, na primer tako što ćete je umesto product.inCollection(id: "gid://shopify/Collection/123456") nazvati product.inSummerBestsellers.

Saznajte više o kreiranju promenljivih iz polja pomoću argumenata.

Za kreiranje promenljivih iz metapolja potrebne su dodatne informacije u aplikaciji Flow, jer sami definišete prostor imena i ključ svakog metapolja, te su argumenti jedinstveni za vašu prodavnicu. Saznajte više o metapoljima u aplikaciji Flow.

Verzionisanje API rešenja

Shopify objavljuje nove verzije API-ja na svaka 3 meseca, a Flow ih usvaja čim je to moguće, iako može da kaska za najnovijom verzijom. Kada je to moguće, promene između verzija rešavaju se automatski, ali neke od njih, što uključuje sledeće situacije, nisu tako jednostavne:

• Uklanjanje polja bez zamene, što potencijalno utiče na procenu uslova ili koda Liquid.
• Polja dobijaju mogućnost za vrednost „null“, što potencijalno utiče na procenu uslova ili koda Liquid.
• Vrednosti nabrajanja se menjaju ili se dodaju novi tipovi unija ili interfejsa, što potencijalno utiče na Liquid ili kôd.
• Argumenti mutacije se menjaju, što potencijalno utiče na konfiguraciju radnji „Pošalji Admin API zahtev“.

Neke tokove posla ćete možda morati ručno da ažurirate. U tim slučajevima se za tokove posla može prikazati greška Potrebno je ažuriranje ili Nepodržan API, a zatim će vam se ponuditi relevantna dokumentacija za API kako biste izvršili neophodne promene u uređivaču toka posla. Nakon završetka i čuvanja ovih ažuriranja, tok posla se automatski ažurira i počinje da koristi najnoviju verziju API-ja dostupnu u aplikaciji Flow.

Možete i da privremeno zanemarite probleme kako biste izvršili hitne izmene u toku posla sa greškama o kompatibilnosti sa verzijom API-ja. Ukoliko ne rešite ove probleme, tok posla bi mogao da prestane sa radom ili da izazove greške kada Shopify više ne bude podržavao stariju verziju API-ja.