Skip to main content
DomovBlogPríručkyPlatnosť požiadavky na sledovanie v reálnom čase vypršala? Pravidlá opakovania, záložného riešenia a stavu, ktoré treba dodržiavať

Platnosť požiadavky na sledovanie v reálnom čase vypršala? Pravidlá opakovania, záložného riešenia a stavu, ktoré treba dodržiavať

17TRACK

Keď vyprší časový limit požiadavky na sledovanie v reálnom čase, považujte najnovší stav zásielky za neznámy — nie za oneskorený, stratený alebo nezmenený. Opakujte požiadavku iba v rámci vopred stanoveného časového rozpočtu a potom zobrazte jasne označenú poslednú známu aktualizáciu alebo používateľa požiadajte, aby to skúsil znova neskôr. Počas celého procesu oddeľujte výsledok požiadavky, aktuálnosť údajov a skutočný stav balíka.

Časový limit požiadavky na sledovanie v reálnom čase, opakovanie, záložné riešenie a stav

Toto rozlíšenie je dôležité pre sledovacie stránky určené zákazníkom aj pre systémy, ktoré používajú údaje o sledovaní na spúšťanie upozornení alebo pracovných postupov podpory. Časový limit vám hovorí, že odpoveď neprišla včas. Nehovorí však, či dopravca zaznamenal novú udalosť, či nadradená služba požiadavku spracovala alebo či sa balík pohol.

Najprv zistite, čo vypršalo

Požiadavka na sledovanie môže zlyhať na viacerých miestach: prehliadač môže prestať čakať na vašu aplikáciu, vaša aplikácia môže prestať čakať na sledovacie API alebo toto API môže vypršať pri komunikácii s inou službou. Používateľ môže v každom prípade vidieť rovnakú všeobecnú chybu, no vhodný ďalší krok sa líši.

  • Časový limit na strane klienta: Aplikácia prestala čakať. Požiadavka na strane servera mohla byť napriek tomu dokončená. Pred odoslaním ďalšej požiadavky, ktorá by mohla duplikovať prácu, skontrolujte vlastné protokoly požiadaviek alebo úložisko výsledkov.
  • Sieťové alebo spojovacie zlyhanie: Váš systém nedostal použiteľnú odpoveď. Nemusíte vedieť, či vzdialená služba požiadavku spracovala.
  • HTTP 504: Brána alebo proxy server nedostali včasnú odpoveď od nadradeného servera. Opisuje to cestu požiadavky, nie zásielku.
  • HTTP 408: Server nedostal úplnú správu požiadavky v čase, počas ktorého bol pripravený čakať. Nejde o stav sledovania u dopravcu.
  • HTTP 200 so starou udalosťou: Požiadavka bola úspešná, ale vrátené informácie o sledovaní môžu byť stále neaktuálne. Úspešná odpoveď HTTP nie je zárukou aktuálnosti.

Tieto výsledky zaznamenávajte ako diagnostiku požiadavky. Neprekladajte žiadny z nich na štítky zásielky, ako napríklad „v preprave“, „problém“ alebo „doručené“. Tieto štítky by mali vychádzať zo sledovacích udalostí alebo z dokumentovaného poľa stavu, nie z transportnej vrstvy.

Použite obmedzené opakovanie, nie nekonečnú slučku

Pri sledovaní určenom iba na čítanie je opakovanie po vypršaní časového limitu často rozumné. Stále však musí byť obmedzené. Opakované požiadavky môžu zvýšiť zaťaženie preťaženej služby, predĺžiť čakanie používateľa a vytvoriť duplicitnú prácu, keď sa viacero aplikačných vrstiev pokúša o opakovanie nezávisle.

  1. Nastavte celkový termín. Určte, ako dlho môže operácia viditeľná používateľovi trvať vrátane prvého pokusu a prípadného opakovania. Každému pokusu nedávajte nový úplný termín, ktorý presahuje čas, počas ktorého môže volajúci čakať.
  2. Overte, či je bezpečné operáciu zopakovať. Vyhľadanie sa zvyčajne líši od požiadavky, ktorá registruje zásielku, mení nastavenia alebo vytvára zdroj. Požiadavku meniacu stav automaticky neopakujte, pokiaľ to nezabezpečuje zmluva poskytovateľa alebo vaše mechanizmy idempotencie.
  3. Prechodné zlyhanie opakujte striedmo. Použite malý, výslovne stanovený rozpočet opakovaní a oneskorenie s náhodnou odchýlkou namiesto súčasného okamžitého opakovania z mnohých klientov.
  4. Dodržujte príslušné pokyny servera. Ak odpoveď obsahuje platnú hlavičku Retry-After, nenaplánujte skoršie opakovanie. Dodržujte aj prísnejší limit aplikácie alebo poskytovateľa.
  5. Po vyčerpaní termínu alebo rozpočtu prestaňte. Prepnite na záložnú odpoveď a podľa potreby samostatne naplánujte neskoršie zosúladenie.

Praktický návrh môže povoliť jedno opakovanie viditeľné používateľovi, ak zostáva dostatok času, a ďalšie pokusy presunúť na aktualizáciu na pozadí. Ide o príklad pravidiel, nie o univerzálne pravidlo API. Limity zvoľte podľa cieľov úrovne služieb, pozorovanej latencie a dokumentácie poskytovateľa. Započítajte aj opakovania vykonané knižnicami HTTP, bránami a pracovníkmi úloh; inak môže zdanlivo mierna politika aplikácie vytvoriť veľké množstvo volaní nadradenej služby.

Pri HTTP 429 považujte odpoveď za signál obmedzenia frekvencie, nie za dôvod na okamžité opakovanie. HTTP 503 môže znamenať dočasnú neschopnosť spracovať požiadavku a server môže poskytnúť Retry-After. Kód 504 môže byť prechodný, no nezaručuje, že ďalší pokus bude úspešný. Chyby overenia zvyčajne vyžadujú kontrolu prihlasovacích údajov alebo oprávnení, zatiaľ čo nesprávne vytvorené požiadavky vyžadujú opravu vstupu. Identifikátor sledovania, ktorý vráti výsledok „nenájdené“, si vyžaduje väčšiu opatrnosť: v závislosti od dokumentovaného správania poskytovateľa a fázy zásielky môže byť na vyhľadanie záznamu príliš skoro alebo môže byť identifikátor nesprávny. Jeden takýto výsledok nepremeňte na definitívne tvrdenie, že balík neexistuje.

Vyberte záložné riešenie, ktoré zachová to, čo viete

Najbezpečnejším záložným riešením je zvyčajne posledný overený výsledok sledovania spolu s vlastným časom udalosti a čestným označením aktuálnosti. Tento výsledok oddeľte od aktuálneho zlyhania požiadavky. Stránka môže uvádzať: „Najnovšia dostupná aktualizácia: Odoslané zo zariadenia. Naposledy skontrolované: [čas]. Novšia aktualizácia je dočasne nedostupná.“ Označenie „Naposledy skontrolované“ uvádzajte iba vtedy, ak ho váš systém skutočne zaznamenáva; nenahrádza čas udalosti u dopravcu.

Použite najpresnejší čas, ktorý dokážete podložiť. Čas udalosti dopravcu opisuje, kedy sa udalosť údajne stala. Čas, keď váš systém túto udalosť prijal, opisuje spracovanie. Čas, keď používateľ otvoril stránku, neopisuje ani jedno z toho. Ak zdroj neposkytuje spoľahlivý čas udalosti alebo časové pásmo, nevymýšľajte si ho. Ak uložený výsledok nemá zaznamenaný čas získania, nazvite ho „posledná dostupná aktualizácia“ namiesto tvrdenia, že bol nedávno obnovený.

Záložné riešenie by malo rešpektovať tri hranice:

  • Zobrazujte uložené údaje ako uložené údaje. Staršiu udalosť neprezentujte ako výsledok požiadavky, ktorej vypršal časový limit.
  • Neodvodzujte priebeh iba z uplynutého času. Balík nie je „na doručení“ len preto, že je niekoľko dní v preprave.
  • Neskrývajte podstatnú neistotu. Ak neexistuje predchádzajúci výsledok, povedzte, že sledovanie je dočasne nedostupné, namiesto zobrazenia vymysleného predvoleného stavu.

Ďalšími záložnými cestami môže byť predtým synchronizované úložisko sledovania, autorizované vyhľadanie u dopravcu alebo neskoršia aktualizácia na pozadí. Použite ich iba vtedy, ak sú vhodné pre zásielku, vaše oprávnenia a podmienky zdroja údajov. Druhý zdroj môže používať iné názvy udalostí alebo mať iné oneskorenia pri nahlasovaní, preto zachovajte pôvod údajov a nekombinujte konfliktné záznamy bez pravidla, ktoré to upravuje. Ak môže zákazník na základe výsledku konať, ponúknite možnosť opakovania alebo kontaktovania podpory namiesto nekonečného zobrazovania načítavania.

Oddeľujte stav požiadavky, aktuálnosť údajov a stav zásielky

Ide o tri rôzne polia, aj keď ich používateľské rozhranie zobrazuje spolu. Stav požiadavky hovorí, či vyhľadanie uspelo, vypršal jeho časový limit alebo prijalo chybu. Aktuálnosť údajov hovorí, kedy boli vrátené alebo uložené informácie zaznamenané. Stav zásielky hovorí, čo zdroj sledovania uvádza o balíku. Ich oddelenie zabraňuje tomu, aby dočasné zlyhanie API prepísalo platnú udalosť doručenia alebo zmenilo starú udalosť „v preprave“ na aktuálne tvrdenie.

Predstavte si napríklad, že systém uchová overenú udalosť „Doručené“ z predchádzajúceho vyhľadania, zatiaľ čo aktuálne obnovenie vyprší. Udalosť doručenia nezmizne. Správny kombinovaný stav je, že posledný dostupný stav zásielky je „doručené“ a najnovšie obnovenie zlyhalo. Naopak, ak je posledná udalosť „V preprave“, vypršanie časového limitu nepotvrdzuje, že balík v tejto chvíli zostáva v preprave; potvrdzuje iba, že nebola získaná novšia odpoveď.

Pri udalostiach prijatých v nesprávnom poradí uplatnite definované pravidlo. Ak je to možné, porovnajte identifikátory udalostí, časové pečiatky, zdroj a dokumentovanú sémantiku stavov poskytovateľa. Nepredpokladajte, že poradie, v ktorom váš systém aktualizácie prijal, je poradím, v ktorom sa udalosti zásielky stali. Ani neskoro prijatá staršia udalosť by nemala automaticky nahradiť novší overený stav. Opravy a výnimky však môžu byť oprávnené, preto nepoužívajte všeobecné pravidlo, podľa ktorého sú zmeny stavu po doručení nemožné. Zachovajte pôvodné udalosti a rozpory preskúmajte namiesto ich tichého prepisovania.

Ak poskytovateľ vráti HTTP 202, interpretujte ho podľa zmluvy daného koncového bodu: prijatie požiadavky samo osebe neznamená dokončené vyhľadanie sledovania. Podobne HTTP 200 potvrdzuje, že požiadavka HTTP bola podľa sémantiky daného koncového bodu úspešná; nedokazuje však, že každé pole sledovania je vyplnené alebo aktuálne. Polia odpovede špecifické pre poskytovateľa mapujte až po kontrole jeho dokumentácie.

Sprístupnite zlyhanie operátorom bez znepokojovania zákazníkov

Užitočný prevádzkový záznam obsahuje ID požiadavky, koncový bod alebo operáciu, počet pokusov, uplynutý čas, vrstvu s časovým limitom, stav HTTP, ak bol prijatý, a informáciu, či odpoveď pochádzala z aktívneho vyhľadania alebo zo záložného riešenia. Pri údajoch o sledovaní zaznamenávajte zdroj a príslušné časové pečiatky udalosti alebo získania. S číslami sledovania a informáciami o zákazníkoch zaobchádzajte podľa pravidiel prístupu a uchovávania vo vašej organizácii; užitočnosť diagnostiky nie je dôvodom na vystavenie úplných identifikátorov v neobmedzených protokoloch.

Sledujte vzorce, nie iba jedno vypršanie časového limitu. Rastúca miera vypršania na jednej trase dopravcu, opakované odpovede 429 alebo zväčšujúca sa medzera medzi časom udalosti dopravcu a časom získania môžu poukazovať na rôzne problémy. Prvý môže vyžadovať preskúmanie u poskytovateľa, druhý riadenie frekvencie a tretí kontrolu synchronizácie alebo doručovania udalostí. Ak aplikácia ponúka sledovanie prostredníctvom poskytovateľa, ako je 17TRACK Tracking API, pred implementáciou týchto všeobecných pravidiel použite dokumentáciu poskytovateľa na overenie polí odpovede, limitov požiadaviek a spracovania chýb špecifických pre koncový bod.

Správa pre zákazníka by mala byť presná a zdržanlivá: „Sledovanie sa momentálne nepodarilo obnoviť. Tu je najnovšia dostupná aktualizácia.“ Ak je to užitočné, uveďte ďalší krok, napríklad opätovnú kontrolu neskôr alebo kontaktovanie podpory, ak je zásielka po očakávanom termíne doručenia uvedenom predajcom alebo dopravcom. Nesľubujte čas obnovenia, ktorý váš systém nedokáže zaručiť.

Kontrolný zoznam pre vydanie procesu sledovania odolného voči časovým limitom

  • Overte, ktorá vrstva ukladá jednotlivé časové limity a ktorá vrstva riadi opakovania.
  • Nastavte celkový termín požiadavky a samostatný, obmedzený rozpočet opakovaní.
  • Overte, že operácie opakované automaticky je bezpečné zopakovať.
  • Dodržujte limity frekvencie a platné pokyny Retry-After.
  • Výsledok požiadavky uchovávajte oddelene od stavu zásielky a histórie udalostí.
  • Označte záložné údaje a podľa možnosti zachovajte ich zdroj a časové pečiatky.
  • Testujte scenáre bez vyrovnávacej pamäte, so zastaranou vyrovnávacou pamäťou, 429, 503, 504 a s neskorou odpoveďou.
  • Overte, že časový limit nemôže spustiť nesprávne upozornenie o doručení ani vymazať overenú udalosť.

Základné pravidlo je jednoduché: požiadavku opakujte iba vtedy, keď je to bezpečné a užitočné; použite záložné riešenie iba s informáciami, ktoré dokážete identifikovať; a nikdy nevytvárajte tvrdenie o stave zásielky na základe časového limitu HTTP.

Často kladené otázky

Mám požiadavku na sledovanie, ktorej vypršal časový limit, okamžite zopakovať?

Nie automaticky. Overte, že operáciu je bezpečné zopakovať, že celkový termín ponecháva čas na ďalší pokus a že žiadny pokyn o obmedzení frekvencie nevyžaduje čakanie. Krátke, obmedzené opakovanie s náhodnou odchýlkou môže byť vhodné pri vyhľadávaní iba na čítanie; opakované okamžité pokusy nie sú dobrým predvoleným postupom.

Znamená HTTP 504, že sledovací systém dopravcu nefunguje?

Nie. Znamená to, že brána alebo proxy server nedostali včasnú odpoveď od nadradenej služby. Problém môže byť kdekoľvek na tejto ceste požiadavky. Nepotvrdzuje to celkovú dostupnosť dopravcu ani stav balíka.

Môžem po vypršaní časového limitu zobraziť posledný známy stav?

Áno, ak ho označíte ako najnovšiu dostupnú informáciu, nie ako úspešné živé obnovenie. Ak sú známe, zobrazte čas udalosti aj čas získania a jasne uveďte, že novšiu aktualizáciu nebolo možné potvrdiť.

Má časový limit zmeniť stav zásielky z „v preprave“ na „problém“?

Nie. Časový limit je zlyhanie požiadavky, nie udalosť zásielky. Stav zásielky zmeňte iba vtedy, keď dôveryhodný zdroj sledovania poskytne udalosť alebo stav, ktorý túto zmenu podporuje.

Čo ak požiadavka, ktorej vypršal časový limit, vytvárala alebo registrovala záznam sledovania?

Nepredpokladajte, že zlyhala. Vzdialený systém ju mohol spracovať ešte pred stratou odpovede. Pred opätovným odoslaním skontrolujte existujúci výsledok a použite zdokumentovaný mechanizmus idempotencie alebo postup obnovy schválený poskytovateľom.

Zdroje