API to krwioobieg nowoczesnego e-commerce. \u0141\u0105czy frontend z backendem, obs\u0142uguje p\u0142atno\u015bci, wysy\u0142ki, magazyn, a nawet rekomendacje. Brzmi jak co\u015b, co dzia\u0142a w tle i nie powinno wp\u0142ywa\u0107 na biznes. B\u0142\u0105d. W s\u0142abo zaprojektowanym API koszty ukryte s\u0105 jak woda w skrzyni bieg\u00f3w \u2013 powoli niszcz\u0105 mechanizm, a Ty p\u0142acisz za naprawy, kt\u00f3rych nie przewidzia\u0142e\u015b.<\/p>\n
Pracuj\u0105c z kilkunastoma sklepami e-commerce, widzia\u0142em trzy powtarzaj\u0105ce si\u0119 b\u0142\u0119dy, kt\u00f3re regularnie winduj\u0105 rachunki i wyd\u0142u\u017caj\u0105 czas wdro\u017cenia nowych funkcji. Oto one.<\/p>\n
Wi\u0119kszo\u015b\u0107 sklep\u00f3w u\u017cywa REST API. To standard, ale \u0142atwo w nim przesadzi\u0107 z liczb\u0105 zapyta\u0144. Znam przypadek klienta, kt\u00f3rego aplikacja mobilna przy ka\u017cdym wej\u015bciu na stron\u0119 g\u0142\u00f3wn\u0105 wysy\u0142a\u0142a 30 osobnych request\u00f3w: po jednym na kategori\u0119, baner, produkt promowany, a nawet stopk\u0119. Ka\u017cde zapytanie to koszt \u2013 zar\u00f3wno po stronie serwera (procesor, pami\u0119\u0107), jak i transferu danych. W chmurze p\u0142acisz za ka\u017cdy gigabajt.<\/p>\n
Rozwi\u0105zanie:<\/strong> Zastosuj GraphQL lub agreguj dane w jednym endpointcie. Sklep, kt\u00f3ry przerobi\u0142em na GraphQL, zmniejszy\u0142 liczb\u0119 request\u00f3w o 70%, a miesi\u0119czny rachunek za API Gateway spad\u0142 o 40%. To nie magia \u2013 to projektowanie z my\u015bl\u0105 o tym, co klient faktycznie wy\u015bwietli.<\/p>\n Konsekwencje biznesowe:<\/strong> W skali 10 000 u\u017cytkownik\u00f3w dziennie nadmiarowe zapytania generuj\u0105 dodatkowe 5-10 GB transferu. W AWS za pr\u00f3g 1 TB zap\u0142acisz ~0,09 USD za GB. Proste: 10 GB * 0,09 USD * 30 dni = 27 USD miesi\u0119cznie. Niby ma\u0142o, ale to tylko jeden symptom. Do\u0142\u00f3\u017c do tego wi\u0119ksz\u0105 liczb\u0119 zapyta\u0144 do bazy danych i dodatkowe obci\u0105\u017cenie serwera \u2013 realny koszt \u0142atwo przekracza 500 USD miesi\u0119cznie.<\/p>\n Drugi b\u0142\u0105d to brak pami\u0119ci podr\u0119cznej. Wiele API zwraca te same dane setki razy: list\u0119 kategorii, ceny produkt\u00f3w, dost\u0119pno\u015b\u0107 magazynow\u0105. Bez cache\u2019owania ka\u017cdy request idzie do bazy danych lub zewn\u0119trznego serwisu. To generuje op\u00f3\u017anienia i koszty \u2013 zar\u00f3wno licencyjne (je\u015bli p\u0142acisz za zapytania do API zewn\u0119trznych), jak i operacyjne.<\/p>\n Przyk\u0142ad: sklep z 500 produktami, kt\u00f3ry wywo\u0142uje endpoint Rozwi\u0105zanie:<\/strong> Wdr\u00f3\u017c cache na poziomie API (np. Varnish, Redis) i ustaw odpowiednie nag\u0142\u00f3wki HTTP (Cache-Control, ETag). Pami\u0119taj, \u017ce w e-commerce niekt\u00f3re dane (ceny, stany magazynowe) musz\u0105 by\u0107 \u015bwie\u017ce, ale wiele (opis produktu, zdj\u0119cia) mo\u017ce by\u0107 cache\u2019owane przez godziny.<\/p>\n Brzmi jak oczywisto\u015b\u0107, ale w praktyce wiele sklep\u00f3w nie wersjonuje API, bo \u201eprzecie\u017c nikt nie korzysta z zewn\u0119trznych integracji\u201d. Tylko \u017ce integracje rosn\u0105: system CRM, narz\u0119dzie do e-mail marketingu, aplikacja mobilna, feed produktowy do Google Shopping. Ka\u017cda zmiana w API psuje co\u015b innego. W efekcie zesp\u00f3\u0142 albo boi si\u0119 zmienia\u0107 endpointy, albo robi to po cichu, psuj\u0105c integracje. Koszt? Godziny debugowania, wsparcie klienta, a w skrajnych przypadkach utrata sprzeda\u017cy.<\/p>\n Znam sklep, kt\u00f3ry przez brak wersjonowania straci\u0142 2 dni pracy zespo\u0142u przy wdro\u017ceniu nowego dostawcy p\u0142atno\u015bci \u2013 bo stary endpoint zmieni\u0142 struktur\u0119 odpowiedzi. Dwie osoby * 2 dni * 500 z\u0142 = 2000 z\u0142. Do tego op\u00f3\u017anienie w uruchomieniu nowej metody p\u0142atno\u015bci, co prze\u0142o\u017cy\u0142o si\u0119 na spadek konwersji o 5% przez tydzie\u0144.<\/p>\n Rozwi\u0105zanie:<\/strong> U\u017cywaj nag\u0142\u00f3wka Projektowanie API w e-commerce to nie tylko kwestia techniczna \u2013 to decyzje biznesowe. Nadmiarowe zapytania, brak cache\u2019a i ignorowanie wersjonowania to trzy b\u0142\u0119dy, kt\u00f3re regularnie widz\u0119 i kt\u00f3re kosztuj\u0105 firmy tysi\u0105ce z\u0142otych miesi\u0119cznie. <\/p>\n Je\u015bli rozpoznajesz kt\u00f3ry\u015b z objaw\u00f3w w swoim sklepie, warto przejrze\u0107 architektur\u0119 API. Cz\u0119sto proste zmiany \u2013 agregacja danych, cache, wersjonowanie \u2013 zwracaj\u0105 si\u0119 w ci\u0105gu kilku tygodni. A je\u015bli potrzebujesz drugiego oka, daj zna\u0107 \u2013 ch\u0119tnie pomog\u0119 znale\u017a\u0107 ukryte koszty.<\/p>\n","protected":false},"excerpt":{"rendered":" Wst\u0119p API to krwioobieg nowoczesnego e-commerce. \u0141\u0105czy frontend z backendem, obs\u0142uguje p\u0142atno\u015bci, wysy\u0142ki, magazyn, a nawet rekomendacje. Brzmi jak co\u015b, co dzia\u0142a w tle i nie powinno wp\u0142ywa\u0107 na biznes. B\u0142\u0105d. W s\u0142abo zaprojektowanym API koszty ukryte s\u0105 jak woda w skrzyni bieg\u00f3w \u2013 powoli niszcz\u0105 mechanizm, a Ty p\u0142acisz za naprawy, kt\u00f3rych nie przewidzia\u0142e\u015b.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[776,699,854,984],"class_list":["post-2603","post","type-post","status-publish","format-standard","hentry","category-warto-wiedziec","tag-ai-e-commerce","tag-api-gateway","tag-koszty-backendu","tag-optymalizacja-api"],"_links":{"self":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2603","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/comments?post=2603"}],"version-history":[{"count":0,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2603\/revisions"}],"wp:attachment":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/media?parent=2603"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/categories?post=2603"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/tags?post=2603"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}2. Brak cache\u2019owania odpowiedzi<\/h2>\n
\/products<\/code> przy ka\u017cdej ods\u0142onie strony g\u0142\u00f3wnej. Bez cache\u2019owania przy 1000 odwiedzin dziennie to 1000 zapyta\u0144 do bazy. Z prostym cache\u2019em Redis lub CDN \u2013 1 zapytanie na 5 minut. R\u00f3\u017cnica w obci\u0105\u017ceniu bazy danych: 1000 vs 1. Koszt reinstancji bazy danych? \u0141atwo kilkaset dolar\u00f3w miesi\u0119cznie.<\/p>\n3. Ignorowanie wersjonowania API<\/h2>\n
Accept<\/code> lub URL z wersj\u0105 (np. \/api\/v2\/products<\/code>). Wprowad\u017a polityk\u0119 deprecacji \u2013 oznacz stare wersje jako przestarza\u0142e, ale nie kasuj ich od razu. Daj partnerom czas na migracj\u0119.<\/p>\nPodsumowanie<\/h2>\n