Shopify Flow ja GraphQL Admin API

Flow luo Shopify Adminia laajentavia ja parantavia integrointeja Shopify GraphQL Admin API:lla. Flow arvioi työnkulkujen ehdot ja muuttujat sekä suorittaa toiminnot Shopify-kaupassasi tällä hetkellä API-versiolla 2024-07. Koska Flow käyttää kaupan tietoja kutsumalla API:a, lähes kaikki API:n kentät ovat käytettävissäsi.

Useimmat Flow'n toiminnot tekevät muutoksia Shopify-kauppaasi API:n avulla. Esimerkiksi Lisää tilaustunnisteet ‑toiminto käyttää tagsAdd-muunnosta. Lähetä Admin API -pyyntö ‑toiminto voi käyttää useimpia muunnoksia, myös sellaisia, jotka eivät vielä ole käytettävissä toimintoina Flow'ssa.

Kun luot työnkulkuja, vastaasi tulee usein API-pohjaisia kenttien nimiä ja kuvauksia. Sinun on ehkä esikatseltava tietoja tai tutustuttava API-dokumentaatioon ymmärtääksesi, mitä tietoja API tuottaa ja mitä tietoja Flow'ssa käytetään, sekä varmistaaksesi, että työnkulku tuottaa odottamasi tiedot.

API:n versiointi

Shopify julkaisee uusia API-versioita joka kolmas kuukausi ja Flow ottaa uudet versiot käyttöön mahdollisimman pian, mutta uusin versio ei ehkä ole välittömästi käytössä. Versioiden väliset muutokset ratkaistaan mahdollisuuksien mukaan automaattisesti, mutta jotkin muutokset eivät välttämättä ole mutkattomia, mukaan lukien: * Kun kenttiä poistetaan, mutta korvaavia kenttiä ei tarjota, tämä saattaa vaikuttaa siihen, miten ehdot tai Liquid arvioidaan. * Kun kentät muuttuvat tyhjäarvot salliviksi, tämä saattaa vaikuttaa siihen, miten ehdot tai Liquid arvioidaan. * Kun enum-arvot muuttuvat tai uusia liitos- tai käyttöliittymätyyppejä lisätään, tämä saattaa vaikuttaa Liquidiin tai koodiin. * Kun mutaatioargumentit muuttuvat, tämä saattaa vaikuttaa Lähetä Admin API ‑pyyntötoimintojen määrityksiin.

Jotkin työnkulut on ehkä päivitettävä manuaalisesti. Näissä tapauksissa työnkuluissa voi näkyä Edellyttää päivitystä- tai API:a ei tueta ‑virhe, ja sinut voidaan ohjata asianmukaiseen API-dokumentaatioon voidaksesi tehdä tarvittavat muutokset työnkulkueditorissa. Kun nämä päivitykset tehdään ja tallennetaan, työnkulku päivitetään automaattisesti niin, että se käyttää uusinta Flow’ssa saatavilla olevaa API-versiota.

Voit halutessasi ohittaa ongelmat tilapäisesti tehdäksesi kiireellisiä muutoksia työnkulkuun, jossa on API-versioiden yhteensopivuusvirheitä. Jos näitä ongelmia ei korjata, työnkulku saattaa lakata toimimasta tai aiheuttaa virheitä, kun Shopify ei enää tue vanhempaa API-versiota.