API to krwioobieg nowoczesnego e-commerce. \u0141\u0105czy frontend z backendem, systemy p\u0142atno\u015bci, magazyny, narz\u0119dzia marketingowe. Ale je\u015bli jest \u017ale zaprojektowane, zamiast pomaga\u0107, zaczyna szkodzi\u0107. Widz\u0119 to na co dzie\u0144: sklepy trac\u0105 klient\u00f3w przez wolne odpowiedzi, niepotrzebne przeci\u0105\u017cenia, a nawet b\u0142\u0119dy, kt\u00f3re generuj\u0105 koszty operacyjne. W tym artykule poka\u017c\u0119 trzy najcz\u0119stsze b\u0142\u0119dy w strategii API, kt\u00f3re realnie wp\u0142ywaj\u0105 na wyniki biznesowe, i podpowiem, jak ich unikn\u0105\u0107.<\/p>\n
Wyobra\u017a sobie czarny pi\u0105tek. Nag\u0142y wzrost ruchu, setki zapyta\u0144 na sekund\u0119. Je\u015bli Twoje API nie ma limit\u00f3w, jeden agresywny klient (lub bot) mo\u017ce zaj\u0105\u0107 wszystkie zasoby, a reszta u\u017cytkownik\u00f3w dostanie timeouty. Widzia\u0142em sklep, kt\u00f3ry straci\u0142 30% przychodu w Black Friday w\u0142a\u015bnie przez to.<\/p>\n
Jak to naprawi\u0107?<\/strong> Wprowad\u017a rate limiting na poziomie API Gateway. Ustal progi np. 100 zapyta\u0144 na minut\u0119 na u\u017cytkownika. Dodaj kolejkowanie dla zapyta\u0144 przekraczaj\u0105cych limit. U\u017cyj algorytmu token bucket \u2013 jest prosty i skuteczny. Pami\u0119taj te\u017c o throttlingu po stronie backendu: je\u015bli system magazynowy nie wyrabia, zwracaj kod 429 z nag\u0142\u00f3wkiem Retry-After. Nie pozw\u00f3l, by jeden klient zniszczy\u0142 do\u015bwiadczenie wszystkim.<\/p>\n Wielu przedsi\u0119biorc\u00f3w decyduje si\u0119 na jedno API, kt\u00f3re obs\u0142uguje ca\u0142\u0105 logik\u0119 sklepu \u2013 od katalogu, przez koszyk, po zam\u00f3wienia. Problem pojawia si\u0119, gdy jedna funkcja (np. wyszukiwarka) zaczyna szwankowa\u0107. Wtedy ca\u0142e API staje si\u0119 niedost\u0119pne. Przyk\u0142ad z \u017cycia: sklep odzie\u017cowy mia\u0142 b\u0142\u0105d w module rekomendacji, kt\u00f3ry powodowa\u0142 b\u0142\u0105d 500 dla ka\u017cdego \u017c\u0105dania. Przez 2 godziny nikt nie m\u00f3g\u0142 z\u0142o\u017cy\u0107 zam\u00f3wienia.<\/p>\n Rozwi\u0105zanie?<\/strong> Zastosuj architektur\u0119 mikroserwisow\u0105 lub przynajmniej podziel API na domeny. U\u017cyj API Gateway, kt\u00f3ry przekierowuje ruch do odpowiednich serwis\u00f3w. Wprowad\u017a circuit breakery \u2013 je\u015bli jeden serwis nie odpowiada, niech reszta dzia\u0142a dalej. W sklepie odzie\u017cowym mogliby\u015bmy mie\u0107 osobne API dla katalogu, koszyka i p\u0142atno\u015bci. Nawet je\u015bli rekomendacje padn\u0105, klient nadal mo\u017ce kupi\u0107.<\/p>\n Cz\u0119sty widok: API zwraca ca\u0142y obiekt produktu z 50 polami, cho\u0107 frontend potrzebuje tylko nazwy, ceny i zdj\u0119cia. To generuje niepotrzebny transfer danych, spowalnia \u0142adowanie strony i m\u0119czy mobilnych u\u017cytkownik\u00f3w. W jednym z audyt\u00f3w widzia\u0142em sklep, gdzie pojedyncze zapytanie do listy produkt\u00f3w zwraca\u0142o 3 MB JSON-a \u2013 przez co strona \u0142adowa\u0142a si\u0119 6 sekund.<\/p>\n Co robi\u0107?<\/strong> Zaimplementuj GraphQL lub przynajmniej umo\u017cliw selekcj\u0119 p\u00f3l przez parametry query (np. fields=name,price). Stosuj paginacj\u0119 z cursor-based (zamiast offset) dla du\u017cych zbior\u00f3w. Dodaj kompresj\u0119 gzip\/Brotli dla odpowiedzi. Pami\u0119taj o cache\u2019owaniu na poziomie CDN \u2013 statyczne dane (np. opisy produkt\u00f3w) nie musz\u0105 by\u0107 generowane przy ka\u017cdym \u017c\u0105daniu.<\/p>\n Strategia API to nie tylko kod \u2013 to decyzje biznesowe. Brak limitowania, monolit i przero\u015bni\u0119te odpowiedzi to trzy najcz\u0119stsze b\u0142\u0119dy, kt\u00f3re kosztuj\u0105 pieni\u0105dze. Wdro\u017cenie throttlingu, podzia\u0142 na domeny oraz optymalizacja transferu danych to inwestycja, kt\u00f3ra zwraca si\u0119 w postaci lepszego UX, wy\u017cszej konwersji i ni\u017cszych koszt\u00f3w serwer\u00f3w. Je\u015bli zarz\u0105dzasz e-commerce, przyjrzyj si\u0119 swojemu API. Mo\u017ce ono by\u0107 Twoj\u0105 najwi\u0119ksz\u0105 przewag\u0105 \u2013 lub najs\u0142abszym ogniwem.<\/p>\n","protected":false},"excerpt":{"rendered":" Wprowadzenie API to krwioobieg nowoczesnego e-commerce. \u0141\u0105czy frontend z backendem, systemy p\u0142atno\u015bci, magazyny, narz\u0119dzia marketingowe. Ale je\u015bli jest \u017ale zaprojektowane, zamiast pomaga\u0107, zaczyna szkodzi\u0107. Widz\u0119 to na co dzie\u0144: sklepy trac\u0105 klient\u00f3w przez wolne odpowiedzi, niepotrzebne przeci\u0105\u017cenia, a nawet b\u0142\u0119dy, kt\u00f3re generuj\u0105 koszty operacyjne. W tym artykule poka\u017c\u0119 trzy najcz\u0119stsze b\u0142\u0119dy w strategii API, kt\u00f3re<\/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":[10,699,513,539],"class_list":["post-2013","post","type-post","status-publish","format-standard","hentry","category-warto-wiedziec","tag-ai-w-e-commerce","tag-api-gateway","tag-bledy-ai","tag-optymalizacja-aplikacji"],"_links":{"self":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2013","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=2013"}],"version-history":[{"count":0,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2013\/revisions"}],"wp:attachment":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/media?parent=2013"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/categories?post=2013"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/tags?post=2013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}B\u0142\u0105d #2: Monolitowe API \u2013 jedno niepowodzenie = wszystko pada<\/h2>\n
B\u0142\u0105d #3: Nieoptymalne odpowiedzi \u2013 przesy\u0142anie \u201ewszystkiego\u201d zamiast \u201etego, co potrzebne\u201d<\/h2>\n
Podsumowanie<\/h2>\n