Pregled API podataka upotrijebljenih u aplikaciji Shopify Flow

Većina tijekova rada pristupa podacima iz vaše trgovine kako biste ih mogli upotrebljavati u uvjetima i radnjama. Shopify Flow pristupa podacima iz trgovine pozivanjem API-ja GraphQL Admin API, čime vam omogućuje pristup gotovo svim poljima u API-ju.

Tijekom izrade tijeka rada često ćete nailaziti na nazive polja i opise temeljene na API-ju, ali možda ćete trebati znati vrijednosti tih podataka. Na primjer, možda ćete htjeti znati naziv aplikacije za narudžbu koja je izrađena iz skice narudžbe. Osim toga, možda ćete htjeti provjeriti daje li vaš tijek rada podatke koje očekujete ili u obliku koji očekujete.

Za pregled vrijednosti podataka imate nekoliko opcija u aplikaciji Shopify Flow.

Pronalaženje polja u administratorskom alatu za Shopify

U većini slučajeva podatke možete pronaći u administratorskom alatu za Shopify. Na primjer, product.title nalazi se na stranici Proizvod.

Dohvaćanje probnih podataka

Prilikom izrade tijeka rada probne podatke možete dohvatiti izravno u uređivaču aplikacije Flow. Budući da podaci aplikacije Flow potječu od događaja, za dohvaćanje točnih probnih podataka najprije morate odabrati relevantan događaj:

1. U uređivaču aplikacije Flow otvorite radnju u kojoj želite upotrijebiti podatke i kliknite na Dodaj varijablu. Alternativno, u uvjetu kliknite na Dodaj kriterije.
2. Kliknite na Konfiguriraj probne podatke.
3. Flow prikazuje prethodne događaje na temelju pokretača tijeka rada. Kliknite na Osvježi događaje za dohvaćanje događaja iz nedavnih pokretanja ili kliknite na Započni osluškivanje događaja uživo i zatim ručno pokrenite događaj u administratorskom alatu ili relevantnoj aplikaciji (za pokretače temeljene na aplikaciji).
4. Nakon što se događaj dogodi, Flow će prikazati pojedinosti o njemu. Odaberite događaj koji želite upotrijebiti za dohvaćanje probnih podataka. Kliknite na Upotrijebi ovaj događaj pokretača.
5. Sada bi se tijekom pregledavanja događaja trebali prikazati probni podaci za svaku varijablu.

Ograničenja:

• Zbog ograničenog prostora, za podatke na popisu Flow će prikazati samo podatke iz prve stavke na popisu.
• Flow može pohraniti do 5 događaja odjednom po tijeku rada.
• Flow ne može dohvatiti događaje iz nedavnih pokretanja za određene pokretače, poput Zakazano vrijeme, Izrađen unos metaobjekta, Korisnik je dodan u segment ili Korisnik je napustio segment.

Upotreba polja u aktivnom tijeku rada

Polja u tijeku rada možete sigurno upotrebljavati uz pomoć radnje Zapiši izlazne podatke u dnevnik. Kada pokrenete tijek rada, radnja Zapiši izlazne podatke u dnevnik ispisat će izlazne podatke svih varijabli i tekst na stranici Povijest pokretanja. Također možete upotrijebiti radnje za slanje obavijesti kao što je Pošalji interni e-mail.

Koraci za upotrebu radnje Zapiši izlazne podatke u dnevnik:

1. Odaberite pokretač koji se može pokrenuti ručno.
2. Dodajte radnju Zapiši izlazne podatke u dnevnik u tijek rada i povežite je s pokretačem.
3. U konfiguraciji Zapiši izlazne podatke u dnevnik kliknite na Dodaj varijablu kako biste dodali varijable koje želite provjeriti u odjeljak Izlazni podaci.
4. Kada završite, kliknite na Uključi tijek rada.
5. Aktivirajte tijek rada tako da ga pokrenete ručno ili da aktivirate pokretač. Na primjer, ako upotrebljavate pokretač Narudžba izrađena, izradite testnu narudžbu.
6. Nakon pokretanja tijeka rada provjerite varijable u zapisniku aktivnosti.

Provjera JSON stranice resursa

Većina stranica resursa u administratorskom alatu za Shopify, poput stranica Narudžba, Proizvod ili Korisnik, omogućuje prikaz podataka koji se poslužuju na stranici. Ovi podaci nemaju potpuno isti naziv i format kao oni koje upotrebljava Shopify Flow, ali vrijednosti odgovaraju onima iz API-ja GraphQL Admin API. Za pregled podataka dodajte .json na kraj URL-a.

Na primjer, dođite do narudžbe tako da u administratorskom alatu za Shopify otvorite stranicu Narudžbe i kliknete na narudžbu. U adresnoj traci preglednika promijenite adresu iz:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

U sljedeću:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

Napomena

Format .json prati REST API. Za nazive varijabli u API-ju REST API upotrebljavaju se donje crte, npr. line_items. GraphQL i Shopify Flow upotrebljavaju kamilju sintaksu (camelCase), npr. lineItems. Osim toga, nazivi polja se ponekad razlikuju, poput properties umjesto customAttributes. Provjerite informacije koje pronađete ovim pristupom.

Upotreba alata GraphiQL ili API alata treće strane

API možete izravno pretraživati pomoću API alata treće strane kao što je Postman ili pomoću besplatnog alata tvrtke Shopify, GraphiQL. Ova opcija pruža najtočnije rezultate, ali zahtijeva određeno poznavanje izrade upita za GraphQL.

Za GraphiQL Shopify nudi web-istraživač za GraphiQL s generičkim podacima te aplikaciju GraphiQL. Pomoću alata GraphiQL možete izraditi GraphQL upit koji točno odgovara nazivima polja u aplikaciji Shopify Flow. Ako upotrebljavate aplikaciju, vrijednosti se također u potpunosti podudaraju s onima iz vaše trgovine.

Pomoću ovog alata možete saznati točno koje podatke Shopify Flow upotrebljava, sa stvarnim podacima iz vaše trgovine. Na primjer, možete izraditi sljedeći upit:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

U sljedećim rezultatima varijabla order / app / name prikazuje naziv aplikacije za narudžbu. U ovom je slučaju narudžba izrađena iz aplikacije za skice narudžbi pa je vrijednost Draft Orders. Informacije o kanalu dostupne su samo za aplikaciju Point of Sale.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }