Preskoči na sadržaj

Šta je Shopify Storefront API?

Definicija

Shopify Storefront API je GraphQL API preko kog bilo koji frontend, na primer headless sajt, mobilna aplikacija ili ekran u radnji, prikazuje proizvode i kolekcije, vodi korpu i šalje kupca na Shopify checkout. Deluje u ime kupca, bez tokena ili sa javnim i privatnim tokenom, i ne može da menja podatke prodavnice.

Kako radi Storefront API

Storefront API je kupčeva strana Shopify API-ja. Omogućava bilo kom frontendu, bilo da je to sajt, mobilna aplikacija ili igra, da prikaže proizvode i kolekcije, napuni korpu i pošalje kupca na checkout. Postoji samo kao GraphQL, bez REST verzije, a svaki zahtev je POST na https://vasa-prodavnica.myshopify.com/api/2026-10/graphql.json.[1]

Šta API vraća zavisi od načina pristupa. Postoje tri nivoa:[1]

  • Pristup bez tokena (tokenless) ne traži nikakav token. Pokriva proizvode, kolekcije, planove pretplate, pretragu, stranice, blogove i članke, kao i korpu, uz ograničenje složenosti upita od 1.000.
  • Javni token, u zaglavlju X-Shopify-Storefront-Access-Token, namenjen je pregledačima i mobilnim aplikacijama, gde svako može da ga vidi.
  • Privatni token, u zaglavlju Shopify-Storefront-Private-Token, mora da ostane tajna i koristi se sa servera. Za saobraćaj kupaca server šalje i IP adresu kupca u Shopify-Storefront-Buyer-IP.

Tagovi proizvoda, metaobjekti i metapolja, meniji i podaci o kupcima dostupni su samo uz token.[1] Za prodavnice na više tržišta, direktiva @inContext traži određenu zemlju, jezik, identitet kupca i saglasnost posetioca, pa isti upit vraća prave cene i prevode za svako tržište, na primer dinarske cene i srpski jezik za Srbiju ako su tako podešeni u prodavnici.[1]

Tokeni: odakle dolaze i šta vide

Najjednostavniji put je Headless kanal. Instalirate ga iz Shopify App Store-a, napravite storefront, a Shopify za njega generiše javni i privatni token. Jedna prodavnica može da ima do 100 aktivnih storefront-a i pristupnih tokena.[2] Programer može da napravi javni token i mutacijom storefrontAccessTokenCreate u Admin API-ju, ili delegirani token za custom aplikaciju.[1]

Svaki token nosi neautentifikovane dozvole (unauthenticated access scopes), koje su dozvole Storefront API-ja. One deluju u ime kupca, a ne zaposlenog. Na primer, unauthenticated_read_product_listings dozvoljava čitanje proizvoda i kolekcija.[3] U tome je ključna razlika u odnosu na Admin API: Storefront token može da prikaže katalog i napravi korpu, ali ne može da promeni cenu niti da čita tuđe porudžbine.

PristupGde stojiTipična upotreba
Bez tokenaBilo gdeJednostavni prikazi proizvoda, korpa[1]
Javni tokenPregledač ili mobilna aplikacijaProdavnice i aplikacije koje rade kod klijenta[1]
Privatni tokenSamo serverHeadless prodavnice koje se renderuju na serveru[1]

Limiti. Zahtevi pravih kupaca nemaju fiksno ograničenje. Botovi i crawleri su ograničeni, strože ako nisu potpisani, pravljenje checkout-a ima ograničenje po minutu, a saobraćaj koji izgleda zlonamerno dobija 430 Shopify Security Rejection.[1] Dakle, velika akcija je bezbedna dokle god server prosleđuje IP kupca i frontend ne zasipa checkout zahtevima.

Primer: jedan katalog, tri prodajna mesta

Uzmimo zamišljeni brend koji prodaje preko headless sajta, iOS aplikacije i ekrana na dodir u partnerskoj radnji. Sva tri čitaju isti Shopify katalog i šalju porudžbine u isti admin.

FrontendTokenZašto
Sajt koji se renderuje na serveruPrivatni token i IP kupcaToken ostaje na serveru, a IP kupca drži saobraćaj kupaca van limita za botove[1]
iOS aplikacijaJavni tokenToken je ugrađen u aplikaciju, pa mora da bude javni[1]
Ekran u radnjiJavni tokenRadi u pregledaču na zajedničkom uređaju

Svaki frontend je poseban storefront u Headless kanalu, pa brend koristi 3 od dozvoljenih 100.[2] Ako token sa ekrana u radnji procuri, brend ukida samo taj storefront, bez diranja sajta i aplikacije. Podaci o proizvodu koji su u metapoljima, kao što su materijal ili tabela veličina, čitaju se uz token, jer pristup bez tokena ne uključuje metapolja.[1]

Checkout i dalje radi na Shopify-ju. Za domaći brend to znači da načini plaćanja podešeni u adminu, kartice preko CorvusPay-a, pouzeće i uplata na račun, rade isto kao u prodavnici sa temom, a integracija za fiskalizaciju i dalje čita porudžbine iz admina. Naš vodič kroz Shopify Hydrogen pokazuje kako Shopify-jev framework koristi Storefront API.

Storefront API vs Admin API

Storefront APIAdmin API
Deluje u imeKupca[3]Zaposlenih u prodavnici ili aplikacije[3]
Tipična upotrebaHeadless prodavnice, mobilne aplikacije, prikazi proizvodaIntegracije, sinhronizacija sa ERP-om, aplikacije za back office
AutentifikacijaBez tokena, javni ili privatni token[1]Pristupni token u X-Shopify-Access-Token[4]
Menja cene ili porudžbineNe; čita katalog i upravlja korpomDa, u okviru svojih dozvola
LimitiNema fiksnog limita za saobraćaj kupaca[1]Poeni u sekundi, prema planu[5]

FAQ

Da li je Shopify Storefront API besplatan?

API se ne plaća posebno. Pristup dolazi uz prodavnicu, bez tokena ili sa tokenima iz Headless kanala ili Admin API-ja. I dalje plaćate Shopify plan, hosting i razvoj.[1][2]

Da li mi treba token za Storefront API?

Ne za osnovno. Pristup bez tokena pokriva proizvode, kolekcije, pretragu, sadržaj i korpu. Za metapolja, metaobjekte, menije i podatke o kupcima treba javni ili privatni token.[1]

Da li Storefront API ima limite?

Nema za saobraćaj pravih kupaca. Botovi i crawleri su ograničeni, pravljenje checkout-a ima limit po minutu, a zahtevi koji izgledaju zlonamerno odbijaju se greškom 430.[1]

Da li je Storefront API REST ili GraphQL?

Samo GraphQL. Storefront API nema REST verziju.[1]

Koliko storefront-a može da ima jedna Shopify prodavnica?

U Headless kanalu do 100 aktivnih storefront-a i pristupnih tokena po prodavnici, svaki sa svojim parom tokena.[2]

Ukratko

Storefront API je GraphQL API preko kog bilo koji frontend prikazuje Shopify katalog, vodi korpu i šalje kupca na Shopify checkout. Deluje u ime kupca, pa čita proizvode i pravi korpe, ali nikad ne menja podatke prodavnice; to je posao Admin API-ja. Javne tokene koristite u pregledaču i aplikacijama, privatne na serveru, a neka ih izdaje Headless kanal. Ako planirate headless prodavnicu, naš headless Shopify tim prvo projektuje sloj API-ja.

Izvori

Koristimo samo primarne izvore: zvaničnu dokumentaciju, stranice proizvoda i propise. Svaki link je proveren na navedeni datum.

  1. Shopify Dev. Storefront API reference. Pristupljeno 17th Nov 2026.
  2. Shopify Dev. Getting started with the Storefront API. Pristupljeno 17th Nov 2026.
  3. Shopify Dev. Access scopes. Pristupljeno 17th Nov 2026.
  4. Shopify Dev. GraphQL Admin API reference. Pristupljeno 17th Nov 2026.
  5. Shopify Dev. GraphQL Admin API rate limits. Pristupljeno 17th Nov 2026.

Treba vam ovo u prodavnici?

Pogledajte uslugu

Checklista koju prolazimo pre nego što dotaknemo kod klijenta

Stiže vam na email, uz nekoliko kratkih poruka u naredne dve nedelje: šta najčešće vidimo na Shopify prodavnicama i šta zaista pomaže.

Bez spama. Odjava u bilo kom trenutku. Politika privatnosti