Verzije Shopify API-ja u 2026: raspored izdanja, podrška i ažuriranje

Shopify izdaje novu verziju API-ja svaka tri meseca, u 17 časova po UTC-u prvog dana svakog kvartala: u januaru, aprilu, julu i oktobru. Verzije nose datum u imenu, na primer 2026-10, a svaka stabilna verzija je podržana najmanje 12 meseci, uz najmanje devet meseci preklapanja sa sledećom. U oktobru 2026. najnovija stabilna verzija je 2026-10, a 2027-01 je release candidate.

Ako aplikacija ili integracija i posle isteka podrške traži staru verziju, Shopify ne vraća grešku. Tiho odgovara najstarijom stabilnom verzijom koja je još dostupna, i to je najčešći razlog zašto integracije „odjednom“ prestanu da rade posle Shopify ažuriranja. Ovde su trenutne verzije, objašnjenje tog prelaska na noviju verziju i rutina za ažuriranje svakog kvartala. Sve je provereno prema Shopify dokumentaciji o verzijama.

Koje verzije Shopify API-ja su trenutno podržane?

Svi datumi su u 15 časova po UTC-u. Obrazac se ponavlja svakog kvartala: izlaze nova stabilna verzija i novi release candidate, a verzija od pre godinu dana izlazi iz podrške.

Kako radi verzionisanje Shopify API-ja?

Verziju upisujete u URL zahteva, pa svaki poziv kaže koju verziju očekuje:

https://your-store.myshopify.com/admin/api/2026-10/graphql.json
https://your-store.myshopify.com/api/2026-10/graphql.json   (Storefront API)

Postoje tri vrste verzija:

• Stabilne verzije su za produkciju. Tokom podrške ne dobijaju izmene koje kvare kompatibilnost.
• Release candidate izlazi istog dana kad i stabilna verzija i najavljuje sledeću. Još može da se promeni na nekompatibilan način, pa služi za testiranje, a ne za produkciju.
• Unstable se stalno menja sa izmenama u toku. Koristite je samo za rano testiranje.

Svaki odgovor ima zaglavlje X-Shopify-API-Version sa verzijom koja je stvarno odgovorila. Webhook poruke se verzionišu na isti način i nose isto zaglavlje.

Šta se dešava kada koristite nepodržanu verziju?

Shopify prelazi na noviju verziju („fall forward“). Na zahtev za povučenu verziju odgovara najstarija stabilna verzija koja je još dostupna. Kod nastavlja da radi, ali dobija odgovore u novijem formatu od onog za koji je pisan. Polja mogu da nestanu ili da promene ime, a ponašanje može da se promeni. Ako se zaglavlje X-Shopify-API-Version razlikuje od verzije u URL-u, Shopify vas je prebacio na noviju verziju.

Zato pokvarena integracija često deluje nasumično: u kodu se ništa nije promenilo, ali je prošao jedan kvartal.

Zašto API integracije pucaju posle Shopify ažuriranja?

Najčešći uzroci su:

• Zaključana verzija koju niko ne ažurira. Integracija je pravljena za verziju od pre dve godine i od tada stalno prelazi na noviju.
• Zaostala verzija webhook-ova. Aplikacije posebno podešavaju verziju API-ja za webhook-ove, na primer u shopify.app.toml. Pozivi se ažuriraju, webhook-ovi ne, i poruke promene oblik.
• Zastarela polja i dalje u upotrebi. Shopify najavljuje zastarevanje mesecima unapred, ali to vide samo oni koji prate changelog ili Dev Dashboard.
• Posrednički alati koje ne kontrolišete. ERP konektori, iPaaS alati i starije aplikacije pozivaju API sa svojim verzijama. Kad oni zaostanu, prodavnica pukne.
• Stari REST pozivi. Shopify je 1. oktobra 2024. proglasio REST Admin API zastarelim (legacy), a nove mogućnosti stižu samo u GraphQL-u. Neki REST pozivi za proizvode su zastareli već u verziji 2024-04.

Za integracije porudžbina i ERP-a pogledajte naš vodič za sinhronizaciju Shopify porudžbina sa ERP-om.

Rutina za ažuriranje svakog kvartala

1. Kad izađe release candidate (januar, april, jul, oktobar), pročitajte beleške o izdanju u changelog-u za developere i napravite spisak izmena koje dotiču vaše upite, mutacije i webhook-ove.
2. Proverite Dev Dashboard. Shopify tamo označava zastarele pozive vaše aplikacije i rok za ispravku. Pozivi se pripisuju aplikaciji čiji ih je token napravio, pa se računaju i interni alati koji koriste isti token.
3. Testirajte novu verziju na razvojnoj prodavnici: pokrenite glavne tokove i ponovo pustite prave webhook poruke.
4. Pomerite verziju API-ja i verziju webhook-ova zajedno, pa objavite.
5. Beležite zaglavlje X-Shopify-API-Version u produkciji i postavite upozorenje kad se razlikuje od verzije koju tražite.

Shopify i sam preporučuje prelazak na najnoviju stabilnu verziju svakog kvartala i navođenje verzije u svakom zahtevu. Rutina od nekoliko koraka na tri meseca mnogo je jeftinija od hitne popravke posle prelaska na noviju verziju.

REST ili GraphQL u 2026?

Gradite na GraphQL Admin API-ju. Od 1. aprila 2025. nove javne aplikacije za Shopify App Store moraju da koriste isključivo GraphQL. Postojeće REST integracije i dalje rade po gornjim pravilima o verzijama, ali nove mogućnosti, kao i neke operacije poput izmene stavki porudžbine, postoje samo u GraphQL-u. Ako planirate migraciju, to je dobar trenutak da uklonite verzije zaključane pre više godina. Takvim poslom se bavi naša usluga API integracija.

FAQ

Koja je najnovija verzija Shopify API-ja?

U oktobru 2026. najnovija stabilna verzija je 2026-10, a 2027-01 je release candidate. Nova stabilna verzija izlazi prvog dana svakog kvartala.

Koliko često Shopify izdaje novu verziju API-ja?

Svaka tri meseca, u 17 časova po UTC-u prvog dana januara, aprila, jula i oktobra.

Koliko dugo je verzija Shopify API-ja podržana?

Najmanje 12 meseci, uz najmanje devet meseci preklapanja između uzastopnih stabilnih verzija.

Šta se dešava ako pozovem verziju Shopify API-ja koja više nije podržana?

Shopify odgovara najstarijom stabilnom verzijom koja je još dostupna. Zahtev uspeva, ali format odgovora može da se razlikuje od onoga što kod očekuje. Proverite zaglavlje X-Shopify-API-Version u odgovoru.

Da li je Shopify REST API zastareo?

Shopify vodi REST Admin API kao zastareo (legacy) od 1. oktobra 2024. Nove javne aplikacije u App Store-u od 1. aprila 2025. moraju da koriste GraphQL. Postojeće REST integracije i dalje rade, ali nove mogućnosti su samo u GraphQL-u.

Kako da vidim koju verziju API-ja koristi moja aplikacija?

Pogledajte verziju u URL-ovima zahteva i u podešavanjima webhook-ova, i beležite zaglavlje X-Shopify-API-Version na odgovorima i webhook-ovima. Dev Dashboard prikazuje i zastarele pozive vaše aplikacije.

Koju verziju API-ja koriste Shopify webhook-ovi?

Verziju za webhook-ove koju podesite za aplikaciju, a ona može da se razlikuje od verzije u API pozivima. Svaki webhook nosi zaglavlje X-Shopify-API-Version, pa to možete da proverite.