Skip to main content
StartBlogPrzewodnikiUpłynął limit czasu żądania śledzenia w czasie rzeczywistym? Zasady ponawiania prób, procedury awaryjnej i statusu, których należy przestrzegać

Upłynął limit czasu żądania śledzenia w czasie rzeczywistym? Zasady ponawiania prób, procedury awaryjnej i statusu, których należy przestrzegać

17TRACK

Gdy żądanie śledzenia w czasie rzeczywistym przekroczy limit czasu, traktuj najnowszy status przesyłki jako nieznany — nie jako opóźniony, zagubiony ani niezmieniony. Ponawiaj próbę tylko w ramach ograniczonego budżetu czasowego, a następnie wyświetl wyraźnie oznaczoną ostatnią znaną aktualizację lub poproś użytkownika o ponowne sprawdzenie później. W całym procesie oddzielaj wynik żądania, aktualność danych i rzeczywisty status przesyłki.

Żądanie śledzenia w czasie rzeczywistym przekroczyło limit czasu — ponawianie, rozwiązanie awaryjne i status

To rozróżnienie ma znaczenie zarówno dla stron śledzenia widocznych dla klientów, jak i dla systemów wykorzystujących dane śledzenia do uruchamiania powiadomień lub procesów obsługi. Przekroczenie limitu czasu oznacza, że odpowiedź nie dotarła na czas. Nie mówi natomiast, czy przewoźnik ma nowe zdarzenie, czy usługa nadrzędna przetworzyła żądanie ani czy przesyłka się przemieściła.

Najpierw ustal, co przekroczyło limit czasu

Żądanie śledzenia może zakończyć się niepowodzeniem w kilku miejscach: przeglądarka może przestać czekać na aplikację, aplikacja może przestać czekać na interfejs API śledzenia albo ten interfejs może przekroczyć limit czasu podczas kontaktowania się z inną usługą. Użytkownik może zobaczyć ten sam ogólny błąd w każdym z tych przypadków, ale właściwe dalsze działanie będzie inne.

  • Limit czasu po stronie klienta: aplikacja przestała czekać. Żądanie po stronie serwera mogło jednak zostać zrealizowane. Przed wysłaniem kolejnego żądania, które mogłoby powielić pracę, sprawdź własne dzienniki żądań lub magazyn wyników.
  • Błąd sieci lub połączenia: system nie otrzymał użytecznej odpowiedzi. Możesz nie wiedzieć, czy zdalna usługa przetworzyła żądanie.
  • HTTP 504: brama lub serwer proxy nie otrzymały na czas odpowiedzi z serwera nadrzędnego. Opisuje to ścieżkę żądania, a nie przesyłkę.
  • HTTP 408: serwer nie otrzymał kompletnego komunikatu żądania w czasie, przez jaki był gotowy czekać. Nie jest to status śledzenia przewoźnika.
  • HTTP 200 ze starym zdarzeniem: żądanie zakończyło się powodzeniem, ale zwrócone informacje o śledzeniu mogą być nadal nieaktualne. Pomyślna odpowiedź HTTP nie gwarantuje aktualności danych.

Rejestruj te wyniki jako diagnostykę żądania. Nie tłumacz żadnego z nich na etykiety przesyłki, takie jak „w transporcie”, „wyjątek” lub „doręczono”. Etykiety te powinny pochodzić ze zdarzeń śledzenia lub udokumentowanego pola statusu, a nie z warstwy transportowej.

Stosuj ograniczone ponawianie, a nie pętlę bez końca

W przypadku wyszukiwania danych śledzenia tylko do odczytu ponowienie próby po przekroczeniu limitu czasu jest często uzasadnione. Nadal powinno być jednak ograniczone. Powtarzane żądania mogą zwiększyć obciążenie przeciążonej usługi, wydłużyć oczekiwanie użytkownika i powodować zduplikowaną pracę, gdy kilka warstw aplikacji ponawia próby niezależnie.

  1. Ustal całkowity termin. Określ, jak długo może trwać operacja widoczna dla użytkownika, uwzględniając pierwszą próbę i ewentualne ponowienie. Nie przydzielaj każdej próbie nowego, pełnego terminu przekraczającego czas, przez który wywołujący może czekać.
  2. Sprawdź, czy operację można bezpiecznie powtórzyć. Wyszukiwanie zwykle różni się od żądania rejestrującego przesyłkę, zmieniającego ustawienia lub tworzącego zasób. Nie odtwarzaj automatycznie żądania zmieniającego stan, chyba że umowa dostawcy lub mechanizmy idempotencji zapewniają bezpieczeństwo takiego działania.
  3. Ostrożnie ponawiaj próbę w przypadku przejściowego błędu. Używaj niewielkiego, wyraźnie określonego budżetu ponowień oraz opóźnienia z losowym składnikiem zamiast wysyłać jednoczesne natychmiastowe ponowienia z wielu klientów.
  4. Przestrzegaj instrukcji serwera. Jeśli odpowiedź zawiera prawidłowy nagłówek Retry-After, nie planuj wcześniejszego ponowienia. Przestrzegaj również wszelkich bardziej rygorystycznych limitów aplikacji lub dostawcy.
  5. Zatrzymaj się po wyczerpaniu terminu lub budżetu. Przełącz się na odpowiedź awaryjną i zaplanuj późniejszą synchronizację osobno, jeśli wymaga tego przepływ pracy.

Praktyczny projekt może zezwalać na jedno ponowienie widoczne dla użytkownika, jeśli pozostało wystarczająco dużo czasu, a kolejne próby przenosić do odświeżania w tle. To przykład polityki, a nie uniwersalna reguła interfejsu API. Ustal limity na podstawie celów poziomu usług, obserwowanych opóźnień i dokumentacji dostawcy. Uwzględniaj również ponowienia wykonywane przez biblioteki HTTP, bramy i procesy robocze; w przeciwnym razie pozornie umiarkowana polityka aplikacji może wygenerować wiele wywołań usług nadrzędnych.

W przypadku HTTP 429 traktuj odpowiedź jako sygnał ograniczenia liczby żądań, a nie jako powód do natychmiastowego ponowienia. HTTP 503 może wskazywać na tymczasową niemożność obsłużenia żądania, a serwer może dostarczyć nagłówek Retry-After. Kod 504 może być przejściowy, ale nie gwarantuje, że kolejna próba się powiedzie. Błędy uwierzytelniania zazwyczaj wymagają sprawdzenia danych uwierzytelniających lub uprawnień, natomiast nieprawidłowe żądania wymagają poprawienia danych wejściowych. Identyfikator śledzenia zwracający wynik „nie znaleziono” wymaga większej ostrożności: w zależności od udokumentowanego działania dostawcy i etapu przesyłki może być jeszcze za wcześnie na znalezienie rekordu albo identyfikator może być nieprawidłowy. Nie wyciągaj na podstawie jednego takiego wyniku ostatecznego wniosku, że przesyłka nie istnieje.

Wybierz rozwiązanie awaryjne, które zachowuje znane informacje

Najbezpieczniejszym rozwiązaniem awaryjnym jest zwykle ostatni zweryfikowany wynik śledzenia wraz z własnym czasem zdarzenia i uczciwą etykietą aktualności. Oddziel ten wynik od bieżącego niepowodzenia żądania. Strona może wyświetlać komunikat: „Najnowsza dostępna aktualizacja: Opuszczono obiekt. Ostatnie sprawdzenie: [czas]. Nowsza aktualizacja jest tymczasowo niedostępna”. Uwzględniaj „Ostatnie sprawdzenie” tylko wtedy, gdy system rzeczywiście je rejestruje; nie zastępuje ono czasu zdarzenia podanego przez przewoźnika.

Używaj najbardziej szczegółowego czasu, jaki możesz uzasadnić. Czas zdarzenia przewoźnika opisuje moment, w którym — według raportu — zdarzenie nastąpiło. Czas otrzymania tego zdarzenia przez system opisuje proces pozyskania danych. Czas otwarcia strony przez użytkownika nie opisuje żadnego z tych momentów. Jeśli źródło nie podaje wiarygodnego czasu zdarzenia lub strefy czasowej, nie wymyślaj jej. Podobnie, jeśli wynik z pamięci podręcznej nie ma zarejestrowanego czasu pobrania, nazwij go „ostatnią dostępną aktualizacją”, zamiast twierdzić, że został niedawno odświeżony.

Rozwiązanie awaryjne powinno respektować trzy zasady:

  • Pokazuj dane z pamięci podręcznej jako dane z pamięci podręcznej. Nie przedstawiaj starszego zdarzenia jako wyniku żądania, które przekroczyło limit czasu.
  • Nie wnioskuj o postępie na podstawie upływu czasu. Przesyłka nie jest „w doręczeniu” tylko dlatego, że od kilku dni znajduje się w transporcie.
  • Nie ukrywaj istotnej niepewności. Jeśli nie ma wcześniejszego wyniku, poinformuj, że śledzenie jest tymczasowo niedostępne, zamiast wyświetlać zmyślny domyślny status.

Inne ścieżki awaryjne mogą obejmować wcześniej zsynchronizowany magazyn danych śledzenia, autoryzowane wyszukiwanie u przewoźnika lub późniejsze odświeżenie w tle. Korzystaj z nich tylko wtedy, gdy są odpowiednie dla przesyłki, posiadanych uprawnień i warunków źródła danych. Drugie źródło może stosować inne nazwy zdarzeń lub mieć inne opóźnienia raportowania, dlatego zachowuj informacje o pochodzeniu i nie łącz sprzecznych rekordów bez reguły określającej sposób ich łączenia. Jeśli klient może podjąć działanie na podstawie wyniku, zapewnij możliwość ponowienia próby lub kontaktu z obsługą zamiast pozostawiać go z niekończącym się wskaźnikiem ładowania.

Oddziel status żądania, aktualność danych i status przesyłki

Są to trzy różne pola, nawet jeśli interfejs użytkownika wyświetla je razem. Status żądania informuje, czy wyszukiwanie zakończyło się powodzeniem, przekroczyło limit czasu lub zwróciło błąd. Aktualność danych wskazuje, kiedy zwrócone lub zapisane informacje zostały zaobserwowane. Status przesyłki informuje, co źródło śledzenia podaje na temat paczki. Rozdzielenie tych elementów zapobiega nadpisaniu prawidłowego zdarzenia doręczenia przez tymczasową awarię interfejsu API lub przekształceniu nieaktualnego zdarzenia „w transporcie” w bieżące twierdzenie.

Na przykład system może przechowywać zweryfikowane zdarzenie „Doręczono” z wcześniejszego wyszukiwania, podczas gdy bieżące odświeżenie przekracza limit czasu. Zdarzenie doręczenia nie znika. Prawidłowy stan łączny to: ostatni dostępny status przesyłki to „doręczono”, a najnowsze odświeżenie zakończyło się niepowodzeniem. Jeśli natomiast ostatnie zdarzenie brzmi „W transporcie”, przekroczenie limitu czasu nie potwierdza, że przesyłka nadal jest w transporcie w tej chwili; potwierdza jedynie, że nie uzyskano nowszej odpowiedzi.

Stosuj określoną regułę, gdy zdarzenia docierają w niewłaściwej kolejności. Porównuj identyfikatory zdarzeń, znaczniki czasu, źródło i udokumentowaną semantykę statusów dostawcy, jeśli są dostępne. Nie zakładaj, że kolejność otrzymywania aktualizacji przez system odpowiada kolejności wystąpienia zdarzeń dotyczących przesyłki. Później otrzymane starsze zdarzenie również nie powinno automatycznie zastępować nowszego, zweryfikowanego statusu. Korekty i wyjątki mogą być jednak uzasadnione, dlatego unikaj ogólnej reguły uznającej zmiany statusu po doręczeniu za niemożliwe. Zachowuj zdarzenia źródłowe i analizuj sprzeczności zamiast po cichu przepisywać historię.

Jeśli dostawca zwraca HTTP 202, interpretuj je zgodnie z umową dotyczącą danego punktu końcowego: przyjęcie żądania samo w sobie nie oznacza zakończenia wyszukiwania danych śledzenia. Podobnie HTTP 200 potwierdza, że żądanie HTTP zakończyło się powodzeniem zgodnie z semantyką tego punktu końcowego; nie dowodzi, że każde pole śledzenia jest obecne lub aktualne. Mapuj pola odpowiedzi specyficzne dla dostawcy dopiero po sprawdzeniu jego dokumentacji.

Uwidocznij awarię operatorom, nie alarmując klientów

Przydatny rekord operacyjny zawiera identyfikator żądania, punkt końcowy lub operację, liczbę prób, czas, który upłynął, warstwę odpowiedzialną za przekroczenie limitu czasu, status HTTP, jeśli został otrzymany, oraz informację, czy odpowiedź pochodziła z bieżącego wyszukiwania, czy z rozwiązania awaryjnego. W przypadku danych śledzenia rejestruj źródło oraz odpowiednie znaczniki czasu zdarzenia lub pobrania. Obsługuj numery śledzenia i dane klientów zgodnie z zasadami dostępu i przechowywania obowiązującymi w organizacji; przydatność diagnostyczna nie uzasadnia ujawniania pełnych identyfikatorów w nieograniczonych dziennikach.

Obserwuj wzorce, zamiast polegać na pojedynczym przekroczeniu limitu czasu. Rosnący odsetek przekroczeń limitu czasu na jednej trasie przewoźnika, powtarzające się odpowiedzi 429 lub zwiększająca się różnica między czasem zdarzenia przewoźnika a czasem pobrania mogą wskazywać na różne problemy. Pierwszy może wymagać analizy dostawcy, drugi — kontroli liczby żądań, a trzeci — sprawdzenia synchronizacji lub dostarczania zdarzeń. Jeśli aplikacja oferuje śledzenie za pośrednictwem dostawcy takiego jak 17TRACK Tracking API, przed wdrożeniem tych ogólnych zasad skorzystaj z dokumentacji dostawcy, aby zweryfikować pola odpowiedzi właściwe dla punktu końcowego, limity żądań i obsługę błędów.

W komunikacie dla klienta zachowaj precyzję i umiar: „Nie udało się teraz odświeżyć śledzenia. Oto najnowsza dostępna aktualizacja”. W razie potrzeby podaj kolejny krok, na przykład ponowne sprawdzenie później lub kontakt z obsługą, jeśli przesyłka przekroczyła przewidywany termin dostawy podany przez sprzedawcę lub przewoźnika. Unikaj obiecywania czasu odświeżenia, którego system nie może zagwarantować.

Lista kontrolna wdrożenia bezpiecznego przepływu śledzenia

  • Potwierdź, która warstwa narzuca każdy limit czasu i która warstwa odpowiada za ponowienia.
  • Ustal całkowity termin żądania oraz osobny, ograniczony budżet ponowień.
  • Sprawdź, czy operacje ponawiane automatycznie można bezpiecznie powtarzać.
  • Przestrzegaj limitów liczby żądań i prawidłowych instrukcji Retry-After.
  • Przechowuj wynik żądania oddzielnie od statusu przesyłki i historii zdarzeń.
  • Oznaczaj dane awaryjne oraz zachowuj ich źródło i znaczniki czasu, gdy są dostępne.
  • Testuj scenariusze bez pamięci podręcznej, z nieaktualną pamięcią podręczną, 429, 503, 504 i opóźnioną odpowiedzią.
  • Sprawdź, czy przekroczenie limitu czasu nie może uruchomić nieprawidłowego powiadomienia o doręczeniu ani usunąć zweryfikowanego zdarzenia.

Nadrzędna zasada jest prosta: ponawiaj żądanie tylko wtedy, gdy jest to bezpieczne i użyteczne; korzystaj z rozwiązania awaryjnego wyłącznie z informacji, które możesz zidentyfikować; i nigdy nie wyciągaj wniosku o statusie przesyłki na podstawie przekroczenia limitu czasu HTTP.

FAQ

Czy należy natychmiast ponowić żądanie śledzenia, które przekroczyło limit czasu?

Nie automatycznie. Sprawdź, czy operację można bezpiecznie powtórzyć, czy całkowity termin pozostawia czas na kolejną próbę oraz czy żadne ograniczenie liczby żądań nie nakazuje oczekiwania. Krótkie, ograniczone ponowienie z losowym opóźnieniem może być odpowiednie dla wyszukiwania tylko do odczytu; wielokrotne natychmiastowe ponowienia nie powinny być domyślnym rozwiązaniem.

Czy HTTP 504 oznacza, że system śledzenia przewoźnika nie działa?

Nie. Oznacza, że brama lub serwer proxy nie otrzymały na czas odpowiedzi z usługi nadrzędnej. Problem może wystąpić w dowolnym miejscu na tej ścieżce żądania. Nie potwierdza to ogólnej dostępności przewoźnika ani stanu przesyłki.

Czy po przekroczeniu limitu czasu mogę wyświetlić ostatni znany status?

Tak, jeśli oznaczysz go jako najnowsze dostępne informacje, a nie jako pomyślne bieżące odświeżenie. Wyświetl czas zdarzenia i czas pobrania, jeśli są znane, oraz jasno zaznacz, że nie można było potwierdzić nowszej aktualizacji.

Czy przekroczenie limitu czasu powinno zmienić status przesyłki z „w transporcie” na „wyjątek”?

Nie. Przekroczenie limitu czasu to niepowodzenie żądania, a nie zdarzenie dotyczące przesyłki. Zmieniaj status przesyłki tylko wtedy, gdy wiarygodne źródło śledzenia dostarczy zdarzenie lub status uzasadniający zmianę.

Co zrobić, jeśli żądanie, które przekroczyło limit czasu, tworzyło lub rejestrowało rekord śledzenia?

Nie zakładaj, że zakończyło się niepowodzeniem. Zdalny system mógł je przetworzyć, zanim odpowiedź została utracona. Przed ponownym wysłaniem sprawdź, czy istnieje wynik, i użyj udokumentowanego mechanizmu idempotencji lub zatwierdzonej przez dostawcę procedury odzyskiwania.

Źródła