Awaria zewnętrznego API: jak przygotować stronę i sklep, gdy pada usługa, od której zależysz

Awaria zewnętrznego API: jak przygotować stronę i sklep, gdy pada usługa, od której zależysz (grafika wygenerowana przez AI)

Awaria zewnętrznego API: jak przygotować stronę i sklep, gdy pada usługa, od której zależysz

W listopadzie 2026 roku platforma ePUAP została prewencyjnie odłączona po wykrytym cyberataku, a przywracanie usług trwało kilka dni. Dla wielu osób był to po prostu kłopot z załatwieniem sprawy urzędowej. Dla właścicieli stron i sklepów to dobry moment na niewygodne pytanie: co dzieje się z moją stroną, gdy przestaje działać usługa, od której zależy?

Bo zależy od wielu. Bramka płatności, API firmy kurierskiej, system fakturowy, mapa w formularzu kontaktowym, newsletter, integracja z hurtownią, logowanie przez zewnętrznego dostawcę. Każda z tych usług może mieć awarię, przerwę serwisową albo po prostu zwolnić. Twój hosting może działać bez zarzutu, a strona i tak przestanie sprzedawać.

Krok 1: spisz mapę zależności

Zacznij od listy. Dla każdej integracji zapisz trzy rzeczy:

  • co robi (np. „pobiera koszt wysyłki w koszyku”),
  • kiedy jest wywoływana (przy każdym wejściu na stronę, przy zamówieniu, raz na dobę),
  • co się stanie, jeśli nie odpowie (strona się nie załaduje, zamówienie się nie złoży, brakuje jednej sekcji).

Już samo spisanie tej listy często pokazuje, że krytyczna ścieżka zakupowa wisi na usłudze, o której nikt w firmie nie pamiętał. Najgroźniejsze są wywołania wykonywane synchronicznie przy każdym wyświetleniu strony — jeśli API po drugiej stronie zamilknie, zamilknie też Twoja strona.

Krok 2: ustaw krótkie timeouty

Domyślnie wiele bibliotek i wtyczek czeka na odpowiedź zewnętrznego serwera bardzo długo. Gdy usługa nie odpowiada, każdy odwiedzający „blokuje” jeden proces PHP na kilkadziesiąt sekund. Przy większym ruchu wolne procesy szybko się kończą i strona zaczyna zwracać błędy — choć sam serwer jest w pełni sprawny.

Dlatego:

  • ustaw krótki timeout połączenia i odpowiedzi dla każdej integracji, która nie musi czekać,
  • po kilku nieudanych próbach z rzędu przestań na chwilę odpytywać usługę (to tzw. circuit breaker) i od razu przechodź do planu awaryjnego,
  • loguj każde przekroczenie czasu — to Twój najszybszy sygnał, że problem jest po drugiej stronie.

Jeśli widzisz w logach błędy 502, 503 lub 504, warto wiedzieć, co oznaczają — opisaliśmy je w artykule o kodach odpowiedzi HTTP i najczęstszych błędach serwera.

Krok 3: przenieś pracę do kolejki

Nie wszystko musi się wydarzyć w momencie, gdy klient klika „Zamawiam”. Wysłanie danych do systemu fakturowego, zamówienie kuriera czy zapis do newslettera można odłożyć na później. Zamówienie zapisuje się w bazie od razu, a zadanie integracyjne trafia do kolejki, z której osobny proces (worker) pobiera je i wykonuje — a w razie awarii ponawia próbę za kilka minut.

Efekt: klient kończy zakup normalnie, nawet jeśli system zewnętrzny akurat leży. Ty nie tracisz zamówienia, a zaległe zadania wykonają się same, gdy usługa wróci.

Uwaga praktyczna: stałe procesy w tle (worker kolejki, harmonogram zadań uruchamiany co minutę, Redis jako broker) wymagają środowiska, w którym masz kontrolę nad procesami. Na hostingu współdzielonym możliwości są zwykle ograniczone, dlatego takie zadania najczęściej trafiają na serwer VPS.

Krok 4: cache i tryb awaryjny zamiast pustej strony

Część danych z zewnętrznych usług zmienia się rzadko: lista punktów odbioru, kursy walut, stany magazynowe z hurtowni. Przechowuj ostatnią poprawną odpowiedź w cache i — gdy API nie odpowiada — pokaż dane z cache z adnotacją, zamiast błędu.

Tam, gdzie cache nie wystarczy, przygotuj tryb awaryjny:

  • gdy nie działa jedna bramka płatności — pokaż alternatywną metodę (np. przelew tradycyjny),
  • gdy nie działa kalkulator wysyłki — zastosuj stałą stawkę i przelicz ją później,
  • gdy nie działa zewnętrzna usługa urzędowa — poinformuj klienta, co może zrobić zamiast tego i kiedy spróbować ponownie.

Uczciwy komunikat („Płatność kartą chwilowo niedostępna — możesz zapłacić przelewem”) sprzedaje lepiej niż biały ekran.

Krok 5: monitoruj nie tylko swoją stronę

Klasyczny monitoring sprawdza, czy Twoja strona odpowiada. To za mało. Dodaj sprawdzanie kluczowych integracji: czy API płatności zwraca poprawną odpowiedź, czy kolejka nie rośnie ponad normę, ile zadań czeka na ponowienie. Podstawy znajdziesz w poradniku jak sprawdzić uptime serwera.

Dobra praktyka: subskrybuj strony statusowe dostawców, z których korzystasz. Często dowiesz się o awarii, zanim zadzwoni pierwszy klient.

Hosting czy VPS — gdzie to wszystko uruchomić?

Prosta strona firmowa z formularzem kontaktowym zwykle nie potrzebuje kolejek i workerów — wystarczy dobrze skonfigurowany hosting www z codziennym backupem i rozsądnie ustawionymi timeoutami we wtyczkach.

Sklep z kilkoma integracjami, system rezerwacji czy aplikacja, która rozmawia z wieloma API, to inna sytuacja. Potrzebujesz tam własnych procesów w tle, dostępu do konsoli i swobody w konfiguracji. Na serwerze VPS w RapidDC dostajesz wirtualizację KVM, obsługę kluczy SSH, ochronę antiDDoS w cenie i wsparcie techniczne 24h/dobę — a najmniejszy plan VPS.Mini (1 vCPU, 1 GB RAM, 10 GB SSD) kosztuje 12 zł netto miesięcznie. Jeśli nie wiesz, które rozwiązanie wybrać, zajrzyj do porównania hosting czy serwer VPS, a pierwsze kroki na serwerze opisaliśmy w poradniku jak połączyć się z serwerem VPS przez SSH.

Podsumowanie

Cudza awaria jest kwestią czasu, nie przypadku. Nie masz wpływu na to, czy bramka płatności, kurier czy usługa urzędowa będzie działać jutro rano. Masz wpływ na to, jak zachowa się Twoja strona: czy zablokuje się na timeoucie, czy spokojnie przyjmie zamówienie, odłoży integrację do kolejki i pokaże klientowi sensowną alternatywę.

Zacznij od mapy zależności, ustaw timeouty, a zadania, które mogą poczekać, przenieś do kolejki. Jeśli Twoja strona potrzebuje do tego własnych procesów w tle, sprawdź serwery VPS RapidDC i wybierz plan dopasowany do skali projektu.

FAQ – najczęściej zadawane pytania o awarię zewnętrznego API

Czy awaria zewnętrznego API może spowolnić cały mój serwer?

Tak. Jeśli strona czeka na odpowiedź usługi, która nie odpowiada, każdy taki request zajmuje proces PHP aż do przekroczenia limitu czasu. Przy większym ruchu wolne procesy się kończą i strona przestaje odpowiadać, mimo że sam serwer działa poprawnie. Krótkie timeouty i circuit breaker temu zapobiegają.

Jak ustawić timeout dla integracji w WordPressie?

Wiele wtyczek ma własne ustawienie limitu czasu w konfiguracji. W kodzie opartym o funkcje HTTP WordPressa możesz przekazać parametr timeout przy wywołaniu zapytania. Ustaw go na tyle krótko, żeby nie blokować strony, ale na tyle długo, by usługa zdążyła odpowiedzieć w normalnych warunkach.

Czy kolejkę zadań da się uruchomić na hostingu współdzielonym?

Prostą kolejkę opartą o bazę danych i zadania harmonogramu czasem tak, ale możliwości są ograniczone, bo na hostingu współdzielonym zwykle nie uruchomisz stałego procesu w tle. Jeśli kolejka ma działać niezawodnie i obsługiwać wiele integracji, lepszym miejscem jest serwer VPS.

Co pokazać klientowi, gdy nie działa bramka płatności?

Jasny komunikat i alternatywę: inną metodę płatności, możliwość opłacenia zamówienia później z linku w mailu albo przelew tradycyjny. Najważniejsze, żeby zamówienie zapisało się w systemie — wtedy płatność można dokończyć, gdy usługa wróci.


Artykuł powstał z wykorzystaniem narzędzi sztucznej inteligencji (AI) pod nadzorem zespołu RapidDC. Grafika ilustracyjna została wygenerowana przez AI.