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 uShopify-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.
| Pristup | Gde stoji | Tipična upotreba |
|---|---|---|
| Bez tokena | Bilo gde | Jednostavni prikazi proizvoda, korpa[1] |
| Javni token | Pregledač ili mobilna aplikacija | Prodavnice i aplikacije koje rade kod klijenta[1] |
| Privatni token | Samo server | Headless 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.
| Frontend | Token | Zašto |
|---|---|---|
| Sajt koji se renderuje na serveru | Privatni token i IP kupca | Token ostaje na serveru, a IP kupca drži saobraćaj kupaca van limita za botove[1] |
| iOS aplikacija | Javni token | Token je ugrađen u aplikaciju, pa mora da bude javni[1] |
| Ekran u radnji | Javni token | Radi 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 API | Admin API | |
|---|---|---|
| Deluje u ime | Kupca[3] | Zaposlenih u prodavnici ili aplikacije[3] |
| Tipična upotreba | Headless prodavnice, mobilne aplikacije, prikazi proizvoda | Integracije, sinhronizacija sa ERP-om, aplikacije za back office |
| Autentifikacija | Bez tokena, javni ili privatni token[1] | Pristupni token u X-Shopify-Access-Token[4] |
| Menja cene ili porudžbine | Ne; čita katalog i upravlja korpom | Da, u okviru svojih dozvola |
| Limiti | Nema 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.
- Shopify Dev. Storefront API reference. Pristupljeno 17th Nov 2026.
- Shopify Dev. Getting started with the Storefront API. Pristupljeno 17th Nov 2026.
- Shopify Dev. Access scopes. Pristupljeno 17th Nov 2026.
- Shopify Dev. GraphQL Admin API reference. Pristupljeno 17th Nov 2026.
- Shopify Dev. GraphQL Admin API rate limits. Pristupljeno 17th Nov 2026.
Treba vam ovo u prodavnici?
Pogledajte usluguChecklista 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.