Vypršel časový limit požadavku na sledování v reálném čase? Pravidla pro opakování, záložní řešení a stav, která je třeba dodržovat
Když požadavek na sledování v reálném čase skončí vypršením časového limitu, považujte nejnovější stav zásilky za neznámý — nikoli za zpožděný, ztracený nebo nezměněný. Opakujte požadavek pouze v rámci omezeného časového rozpočtu a poté zobrazte jasně označenou poslední známou aktualizaci nebo uživatele požádejte, aby to zkusil znovu později. Během celého procesu oddělujte výsledek požadavku, aktuálnost dat a skutečný stav zásilky.

Toto rozlišení je důležité jak pro sledovací stránky určené zákazníkům, tak pro systémy, které používají sledovací data ke spouštění oznámení nebo podpůrných pracovních postupů. Vypršení časového limitu znamená, že odpověď nedorazila včas. Neříká však, zda dopravce zaznamenal novou událost, zda nadřazená služba požadavek zpracovala nebo zda se zásilka posunula.
Nejprve zjistěte, co přesně vypršelo
Požadavek na sledování může selhat na několika místech: prohlížeč může přestat čekat na vaši aplikaci, vaše aplikace může přestat čekat na sledovací API nebo toto API může při kontaktování jiné služby překročit časový limit. Uživatel může v každém případě vidět stejnou obecnou chybu, ale vhodný další krok se liší.
- Časový limit na straně klienta: Aplikace přestala čekat. Požadavek na straně serveru mohl být přesto dokončen. Před odesláním dalšího požadavku, který by mohl duplikovat práci, zkontrolujte vlastní protokoly požadavků nebo úložiště výsledků.
- Selhání sítě nebo připojení: Váš systém neobdržel použitelnou odpověď. Nemusíte vědět, zda vzdálená služba požadavek zpracovala.
- HTTP 504: Brána nebo proxy neobdržela včasnou odpověď od nadřazeného serveru. Toto popisuje cestu požadavku, nikoli zásilku.
- HTTP 408: Server neobdržel úplnou zprávu požadavku během doby, po kterou byl připraven čekat. Nejde o stav sledování u dopravce.
- HTTP 200 se starou událostí: Požadavek byl úspěšný, ale vrácené informace o sledování mohou být stále zastaralé. Úspěšná odpověď HTTP není zárukou aktuálnosti.
Tyto výsledky zaznamenávejte jako diagnostiku požadavků. Nepřevádějte žádný z nich na štítky zásilky, jako jsou „v přepravě“, „výjimka“ nebo „doručeno“. Tyto štítky musí vycházet ze sledovacích událostí nebo zdokumentovaného stavového pole, nikoli z transportní vrstvy.
Použijte omezené opakování, nikoli nekonečnou smyčku
U vyhledávání sledování pouze pro čtení je opakování po vypršení časového limitu často rozumné. Přesto musí být omezené. Opakované požadavky mohou zvýšit zatížení přetížené služby, prodloužit čekání uživatele a vytvořit duplicitní práci, když několik vrstev aplikace opakuje požadavek nezávisle.
- Nastavte celkovou lhůtu. Určete, jak dlouho může operace určená uživateli trvat včetně prvního pokusu a případného opakování. Nedávejte každému pokusu novou plnou lhůtu, která překračuje dobu, po kterou může volající čekat.
- Ověřte, zda je operaci bezpečné opakovat. Vyhledávání se obvykle liší od požadavku, který registruje zásilku, mění nastavení nebo vytváří zdroj. Požadavek měnící stav neopakujte automaticky, pokud to bezpečně nezajišťuje smlouva poskytovatele nebo vaše mechanismy idempotence.
- Přechodné selhání opakujte střídmě. Použijte malý, výslovně stanovený rozpočet opakování a prodlevu s náhodným rozptylem místo současného okamžitého opakování z mnoha klientů.
- Respektujte pokyny serveru. Pokud odpověď obsahuje platnou hlavičku
Retry-After, nenaplánujte opakování dříve. Respektujte také případný přísnější limit aplikace nebo konkrétního poskytovatele. - Po vyčerpání lhůty nebo rozpočtu skončete. Přepněte na záložní odpověď a případné pozdější opětovné ověření naplánujte samostatně, pokud ho váš pracovní postup potřebuje.
Praktický návrh může umožnit jedno opakování určené uživateli, pokud zbývá dostatek času, a další pokusy přesunout na aktualizaci na pozadí. Jde o příklad zásady, nikoli o univerzální pravidlo API. Limity zvolte podle cílů úrovně služeb, pozorované latence a dokumentace poskytovatele. Započítejte také opakování prováděná knihovnami HTTP, branami a pracovníky úloh; jinak může zdánlivě umírněná zásada aplikace vést k mnoha voláním nadřazených služeb.
U HTTP 429 považujte odpověď za signál omezení rychlosti, nikoli za důvod k okamžitému opakování. HTTP 503 může znamenat dočasnou neschopnost zpracovat požadavek a server může poskytnout Retry-After. Kód 504 může být přechodný, ale nezaručuje, že další pokus uspěje. Chyby ověřování obvykle vyžadují kontrolu přihlašovacích údajů nebo oprávnění, zatímco chybně vytvořené požadavky vyžadují opravu vstupu. Identifikátor sledování, který vrátí výsledek „nenalezeno“, vyžaduje větší opatrnost: v závislosti na zdokumentovaném chování poskytovatele a fázi zásilky může být na nalezení záznamu příliš brzy nebo může být identifikátor nesprávný. Jeden takový výsledek nepřevádějte na definitivní tvrzení, že zásilka neexistuje.
Vyberte záložní řešení, které zachová to, co víte
Nejbezpečnější záložní možností je obvykle poslední ověřený výsledek sledování doplněný vlastním časem události a poctivým označením aktuálnosti. Tento výsledek oddělte od aktuálního selhání požadavku. Stránka může uvádět: „Nejnovější dostupná aktualizace: Opuštění zařízení. Naposledy ověřeno: [čas]. Novější aktualizace je dočasně nedostupná.“ Položku „Naposledy ověřeno“ uvádějte pouze tehdy, pokud ji váš systém skutečně zaznamenává; nenahrazuje čas události u dopravce.
Použijte nejpřesnější čas, který dokážete podložit. Čas události u dopravce popisuje, kdy podle hlášení k události došlo. Čas, kdy váš systém tuto událost přijal, popisuje příjem dat. Čas, kdy uživatel otevřel stránku, nepopisuje ani jedno. Pokud zdroj neposkytuje spolehlivý čas události nebo časové pásmo, žádné nevymýšlejte. Stejně tak pokud uložený výsledek nemá zaznamenaný čas načtení, označte ho jako „poslední dostupnou aktualizaci“, místo abyste tvrdili, že byl nedávno obnoven.
Záložní řešení by mělo dodržovat tři hranice:
- Uložená data zobrazujte jako uložená data. Starší událost nezobrazujte jako výsledek požadavku, u něhož vypršel časový limit.
- Neodvozujte průběh z uplynulého času. Zásilka není „na rozvozu“ jen proto, že je několik dní v přepravě.
- Neskrývejte podstatnou nejistotu. Pokud neexistuje předchozí výsledek, uveďte, že sledování je dočasně nedostupné, místo zobrazení smyšleného výchozího stavu.
Další záložní možnosti mohou zahrnovat dříve synchronizované úložiště sledování, autorizované vyhledání u dopravce nebo pozdější aktualizaci na pozadí. Používejte je pouze tehdy, pokud odpovídají zásilce, vašim oprávněním a podmínkám zdroje dat. Druhý zdroj může mít jiné názvy událostí nebo zpoždění při hlášení, proto zachovávejte původ dat a neslučujte konfliktní záznamy bez pravidla, které takové slučování upravuje. Pokud může zákazník na základě výsledku jednat, nabídněte možnost opakování nebo kontaktování podpory místo nekonečně zobrazeného načítání.
Oddělujte stav požadavku, aktuálnost dat a stav zásilky
Jde o tři různá pole, i když je uživatelské rozhraní zobrazuje společně. Stav požadavku udává, zda vyhledávání uspělo, vypršel jeho časový limit nebo došlo k chybě. Aktuálnost dat udává, kdy byly vrácené nebo uložené informace zaznamenány. Stav zásilky udává, co zdroj sledování hlásí o zásilce. Jejich oddělení zabrání tomu, aby dočasné selhání API přepsalo platnou událost doručení nebo změnilo zastaralou událost „v přepravě“ na aktuální tvrzení.
Například systém může při aktuálním obnovení, jehož časový limit vypršel, stále uchovávat ověřenou událost „Doručeno“ z dřívějšího vyhledávání. Událost doručení nezmizí. Správný kombinovaný stav je, že poslední dostupný stav zásilky je „doručeno“ a nejnovější obnovení selhalo. Naopak pokud je poslední událostí „V přepravě“, vypršení časového limitu nepotvrzuje, že zásilka v tomto okamžiku zůstává v přepravě; potvrzuje pouze, že nebyla získána novější odpověď.
Po příchodu událostí mimo pořadí použijte stanovené pravidlo. Pokud je to možné, porovnejte identifikátory událostí, časová razítka, zdroj a zdokumentovanou sémantiku stavů poskytovatele. Nepředpokládejte, že pořadí, ve kterém váš systém aktualizace přijal, odpovídá pořadí, ve kterém ke sledovacím událostem došlo. Ani později doručená starší událost by neměla automaticky nahradit novější ověřený stav. Opravy a výjimky však mohou být legitimní, proto nepoužívejte obecné pravidlo, které považuje změny stavu po doručení za nemožné. Zachovejte podkladové události a rozpory prošetřete, místo abyste historii tiše přepsali.
Pokud poskytovatel vrátí HTTP 202, interpretujte ho podle smlouvy daného koncového bodu: přijetí požadavku samo o sobě neznamená dokončené vyhledávání sledování. Podobně HTTP 200 potvrzuje, že požadavek HTTP byl podle sémantiky daného koncového bodu úspěšný; nedokazuje však, že každé sledovací pole existuje nebo je aktuální. Pole odpovědi specifická pro poskytovatele mapujte až po ověření jeho dokumentace.
Zviditelněte selhání operátorům, aniž byste znepokojovali zákazníky
Užitečný provozní záznam obsahuje ID požadavku, koncový bod nebo operaci, počet pokusů, uplynulý čas, vrstvu s vypršeným časovým limitem, stav HTTP, pokud byl přijat, a informaci, zda odpověď pocházela z aktuálního vyhledávání nebo záložního řešení. U sledovacích dat zaznamenávejte zdroj a příslušná časová razítka události nebo načtení. S čísly zásilek a informacemi o zákaznících nakládejte podle pravidel vaší organizace pro přístup a uchovávání; diagnostická užitečnost není důvodem k vystavení úplných identifikátorů v neomezených protokolech.
Sledujte vzorce, nikoli jediný případ vypršení časového limitu. Rostoucí počet překročení limitu na jedné trase dopravce, opakované odpovědi 429 nebo zvětšující se rozdíl mezi časem události u dopravce a časem načtení mohou ukazovat na různé problémy. První může vyžadovat šetření u poskytovatele, druhý řízení rychlosti a třetí kontrolu synchronizace nebo doručování událostí. Pokud aplikace nabízí sledování prostřednictvím poskytovatele, jako je 17TRACK Tracking API, před implementací těchto obecných pravidel ověřte v dokumentaci poskytovatele pole odpovědi, limity požadavků a zpracování chyb specifické pro jednotlivé koncové body.
Zpráva určená zákazníkovi by měla být přesná a střídmá: „Sledování se nyní nepodařilo aktualizovat. Zde je nejnovější dostupná aktualizace.“ Pokud je to užitečné, uveďte další krok, například kontrolu později nebo kontaktování podpory, pokud je zásilka mimo očekávané dodací okno uvedené prodejcem nebo dopravcem. Neslibujte dobu aktualizace, kterou váš systém nemůže zaručit.
Kontrolní seznam pro vydání procesu sledování bezpečného při vypršení časového limitu
- Potvrďte, která vrstva stanovuje jednotlivé časové limity a která vrstva vlastní opakování.
- Nastavte celkovou lhůtu požadavku a samostatný omezený rozpočet opakování.
- Ověřte, že operace opakované automaticky lze bezpečně opakovat.
- Respektujte limity rychlosti a platné pokyny
Retry-After. - Ukládejte výsledek požadavku odděleně od stavu zásilky a historie událostí.
- Označte záložní data a pokud možno uchovejte jejich zdroj a časová razítka.
- Testujte scénáře bez mezipaměti, se zastaralou mezipamětí, 429, 503, 504 a pozdní odpovědí.
- Ověřte, že vypršení časového limitu nemůže spustit nesprávné oznámení o doručení ani vymazat ověřenou událost.
Základní pravidlo je jednoduché: požadavek opakujte pouze tehdy, když je to bezpečné a užitečné; jako záložní řešení používejte pouze informace, které dokážete identifikovat; a nikdy nevytvářejte tvrzení o stavu zásilky na základě vypršení časového limitu HTTP.
Časté dotazy
Mám požadavek na sledování, jehož časový limit vypršel, okamžitě opakovat?
Ne automaticky. Ověřte, že je operaci bezpečné opakovat, že celková lhůta ponechává čas na další pokus a že žádný pokyn k omezení rychlosti nevyžaduje čekání. Krátké, omezené opakování s náhodným rozptylem může být u vyhledávání pouze pro čtení vhodné; opakované okamžité pokusy však nejsou vhodným výchozím nastavením.
Znamená HTTP 504, že sledovací systém dopravce nefunguje?
Ne. Znamená, že brána nebo proxy neobdržela včasnou odpověď od nadřazené služby. Problém může být kdekoli na této cestě požadavku. Tento stav nepotvrzuje celkovou dostupnost dopravce ani stav zásilky.
Mohu po vypršení časového limitu zobrazit poslední známý stav?
Ano, pokud ho označíte jako nejnovější dostupnou informaci, nikoli jako úspěšné aktuální obnovení. Pokud jsou známy, zobrazte čas události a čas načtení a jasně uveďte, že novější aktualizaci se nepodařilo potvrdit.
Měl by vypršený časový limit změnit zásilku ze stavu „v přepravě“ na „výjimka“?
Ne. Vypršení časového limitu je selhání požadavku, nikoli událost zásilky. Stav zásilky měňte pouze tehdy, když důvěryhodný zdroj sledování poskytne událost nebo stav, který takovou změnu podporuje.
Co když požadavek, jehož časový limit vypršel, vytvářel nebo registroval záznam sledování?
Nepředpokládejte, že selhal. Vzdálený systém ho mohl zpracovat dříve, než se odpověď ztratila. Před opětovným odesláním zkontrolujte existující výsledek a použijte zdokumentovaný mechanismus idempotence nebo postup obnovy schválený poskytovatelem.
Zdroje
- RFC 9110, HTTP Semantics — definice stavů HTTP,
Retry-Aftera úvahy týkající se opakování požadavků. - RFC 6585, Additional HTTP Status Codes — definice HTTP 429 a jeho použití s
Retry-After. - Amazon Builders’ Library, „Timeouts, retries, and backoff with jitter“ — technické pokyny k zesilování opakování, zpětnému odkladu a náhodnému rozptylu.
- Dokumentace 17TRACK Tracking API — reference pro ověření chování API specifického pro poskytovatele před implementací.


