Časovna omejitev zahteve za sledenje v realnem času? Pravila za ponovni poskus, nadomestni način in stanje, ki jih je treba upoštevati
Ko zahteva za sledenje v realnem času poteče, naj bo najnovejši status pošiljke obravnavan kot neznan – ne kot zamujen, izgubljen ali nespremenjen. Ponovno poskusite le v okviru omejenega časovnega proračuna, nato prikažite jasno označeno zadnjo znano posodobitev ali uporabnika prosite, naj poskusi znova pozneje. Ves čas postopka ločujte izid zahteve, svežino podatkov in dejanski status paketa.
To razlikovanje je pomembno tako za strani za sledenje, namenjene strankam, kot za sisteme, ki podatke o sledenju uporabljajo za sprožanje obvestil ali podpornih postopkov. Časovna prekoračitev pomeni, da odgovor ni prispel pravočasno. Ne pove pa, ali je prevoznik zabeležil nov dogodek, ali je zaledna storitev obdelala zahtevo ali ali se je paket premaknil.
Najprej ugotovite, kaj je poteklo
Zahteva za sledenje lahko odpove na več točkah: brskalnik lahko preneha čakati na vašo aplikacijo, vaša aplikacija lahko preneha čakati na API za sledenje ali pa lahko ta API poteče med vzpostavljanjem stika z drugo storitvijo. Uporabnik lahko v vseh primerih vidi isto splošno napako, vendar se ustrezen naslednji korak razlikuje.
- Časovna prekoračitev na strani odjemalca: Aplikacija je prenehala čakati. Zahteva na strani strežnika je bila morda še vedno dokončana. Pred izdajo nove zahteve, ki bi lahko podvojila delo, preverite lastne dnevnike zahtev ali shrambo rezultatov.
- Omrežna ali povezavna napaka: Vaš sistem ni prejel uporabnega odgovora. Morda ne veste, ali je oddaljena storitev obdelala zahtevo.
- HTTP 504: Prehod ali posredniški strežnik ni pravočasno prejel odgovora od zalednega strežnika. To opisuje pot zahteve, ne pošiljke.
- HTTP 408: Strežnik v času, ko je bil pripravljen čakati, ni prejel celotnega sporočila zahteve. To ni status sledenja pri prevozniku.
- HTTP 200 z zastarelim dogodkom: Zahteva je bila uspešna, vendar so vrnjene informacije o sledenju lahko še vedno zastarele. Uspešen odgovor HTTP ni zagotovilo svežine.
Te izide zabeležite kot diagnostiko zahtev. Nobenega od njih ne prevajajte v oznake pošiljke, kot so »v tranzitu«, »izjema« ali »dostavljeno«. Te oznake morajo izhajati iz dogodkov sledenja ali dokumentiranega polja statusa, ne iz transportnega sloja.
Uporabite omejen ponovni poskus, ne neskončne zanke
Pri iskanju podatkov o sledenju, ki je samo za branje, je ponovni poskus po časovni prekoračitvi pogosto smiseln. Kljub temu mora biti omejen. Ponavljajoče se zahteve lahko povečajo obremenitev preobremenjene storitve, podaljšajo čakanje uporabnika in ustvarijo podvojeno delo, kadar več aplikacijskih plasti neodvisno ponavlja zahteve.
- Nastavite skupni rok. Določite, koliko časa lahko traja operacija, namenjena uporabniku, vključno z začetnim poskusom in morebitnim ponovnim poskusom. Vsakemu poskusu ne dodelite novega celotnega roka, ki presega čas, ki ga lahko klicatelj čaka.
- Preverite, ali je operacijo varno ponoviti. Iskanje se običajno razlikuje od zahteve, ki registrira pošiljko, spreminja nastavitve ali ustvari vir. Zahteve, ki spreminja stanje, ne ponavljajte samodejno, razen če je to zaradi pogodbe ponudnika ali vaših mehanizmov idempotentnosti varno.
- Prehodno napako ponovite zmerno. Uporabite majhen, izrecen proračun za ponovne poskuse in zakasnitev z naključnim odmikom, namesto da bi številni odjemalci hkrati pošiljali takojšnje ponovne poskuse.
- Upoštevajte navodila strežnika. Če odgovor vključuje veljavno glavo
Retry-After, ponovnega poskusa ne načrtujte prej. Upoštevajte tudi morebitne strožje omejitve aplikacije ali ponudnika. - Ustavite se, ko rok ali proračun poteče. Preklopite na nadomestni odgovor in poznejšo uskladitev načrtujte ločeno, če jo vaš potek dela potrebuje.
Praktična zasnova lahko omogoči en ponovni poskus, namenjen uporabniku, če je na voljo dovolj časa, nadaljnje poskuse pa premakne v osveževanje v ozadju. To je primer pravilnika, ne univerzalno pravilo API-ja. Omejitve izberite glede na cilje ravni storitve, opaženo zakasnitev in dokumentacijo ponudnika. Upoštevajte tudi ponovne poskuse knjižnic HTTP, prehodov in izvajalcev opravil; sicer lahko navidezno zmeren pravilnik aplikacije povzroči veliko klicev zalednih storitev.
Pri HTTP 429 odgovor obravnavajte kot signal omejitve hitrosti, ne kot razlog za takojšen ponovni poskus. HTTP 503 lahko pomeni začasno nezmožnost obdelave zahteve, strežnik pa lahko posreduje Retry-After. HTTP 504 je lahko prehoden, vendar ne zagotavlja, da bo naslednji poskus uspešen. Napake pri preverjanju pristnosti običajno zahtevajo preverjanje poverilnic ali dovoljenj, napačno oblikovane zahteve pa popravek vnosa. Identifikator za sledenje, ki vrne rezultat »ni najdeno«, zahteva več previdnosti: glede na dokumentirano vedenje ponudnika in fazo pošiljke je morda še prezgodaj za iskanje zapisa ali pa je identifikator napačen. Enkratnega takega rezultata ne pretvorite v dokončno trditev, da paket ne obstaja.
Izberite nadomestno možnost, ki ohrani to, kar veste
Najvarnejša nadomestna možnost je običajno zadnji preverjeni rezultat sledenja, skupaj z lastnim časom dogodka in pošteno oznako svežine. Ta rezultat naj bo ločen od trenutne napake zahteve. Stran lahko na primer prikaže: »Najnovejša razpoložljiva posodobitev: Odhod iz objekta. Nazadnje preverjeno: [čas]. Novejša posodobitev trenutno ni na voljo.« »Nazadnje preverjeno« vključite le, če ga vaš sistem dejansko beleži; to ni nadomestilo za čas dogodka pri prevozniku.
Uporabite čim bolj natančen čas, ki ga lahko podprete. Čas dogodka pri prevozniku opisuje, kdaj naj bi se dogodek zgodil. Čas, ko je vaš sistem prejel ta dogodek, opisuje vnos. Čas, ko je uporabnik odprl stran, ne opisuje nobenega od njiju. Če vir ne zagotavlja zanesljivega časa dogodka ali časovnega pasu, si ga ne izmišljajte. Če predpomnjeni rezultat prav tako nima zabeleženega časa pridobitve, ga imenujte »zadnja razpoložljiva posodobitev«, namesto da bi trdili, da je bil nedavno osvežen.
Nadomestna možnost mora upoštevati tri meje:
- Predpomnjene podatke prikažite kot predpomnjene podatke. Starejšega dogodka ne prikažite kot rezultata zahteve, ki je potekla.
- Napredka ne sklepajte iz pretečenega časa. Paket ni »na dostavi« zgolj zato, ker je že več dni v tranzitu.
- Ne skrivajte pomembne negotovosti. Če predhodnega rezultata ni, povejte, da sledenje začasno ni na voljo, namesto da prikažete izmišljeni privzeti status.
Druge nadomestne poti lahko vključujejo predhodno usklajeno shrambo sledenja, pooblaščeno iskanje pri prevozniku ali poznejše osveževanje v ozadju. Uporabite jih le, če ustrezajo pošiljki, vašim dovoljenjem in pogojem vira podatkov. Drugi vir ima lahko drugačna imena dogodkov ali zamude pri poročanju, zato ohranite izvor podatkov in se izogibajte združevanju nasprotujočih si zapisov brez pravila, ki določa, kako to storiti. Če lahko stranka ukrepa na podlagi rezultata, ji ponudite možnost ponovnega poskusa ali stika s podporo, namesto da bi jo za nedoločen čas pustili čakati na indikator.
Status zahteve, svežino podatkov in status pošiljke ohranite ločene
To so tri različna polja, tudi če jih uporabniški vmesnik prikazuje skupaj. Status zahteve pove, ali je bilo iskanje uspešno, je poteklo ali je prejelo napako. Svežina podatkov pove, kdaj so bile vrnjene ali shranjene informacije opažene. Status pošiljke pove, kaj vir sledenja poroča o paketu. Ločevanje preprečuje, da bi začasna napaka API-ja prepisala veljaven dogodek dostave ali spremenila zastarel dogodek »v tranzitu« v trenutno trditev.
Na primer, sistem lahko medtem, ko trenutna osvežitev poteče, ohrani preverjeni dogodek »Dostavljeno« iz prejšnjega iskanja. Dogodek dostave ne izgine. Pravilno združeno stanje je, da je zadnji razpoložljivi status pošiljke »dostavljeno«, najnovejša osvežitev pa ni uspela. Če je zadnji dogodek »V tranzitu«, časovna prekoračitev ne potrjuje, da paket v tem trenutku ostaja v tranzitu; potrjuje le, da ni bil pridobljen novejši odgovor.
Ko dogodki prispejo v napačnem vrstnem redu, uporabite določeno pravilo. Če je mogoče, primerjajte identifikatorje dogodkov, časovne žige, vir in dokumentirano semantiko statusov ponudnika. Ne predpostavljajte, da vrstni red, v katerem je vaš sistem prejel posodobitve, ustreza vrstnemu redu, v katerem so se dogodki pošiljke zgodili. Prav tako pozneje prispeli starejši dogodek ne sme samodejno nadomestiti novejšega preverjenega statusa. Popravki in izjeme so lahko legitimni, zato se izogibajte splošnemu pravilu, ki spremembe statusa po dostavi obravnava kot nemogoče. Ohranite osnovne dogodke in protislovja preučite, namesto da bi zgodovino tiho prepisali.
Če ponudnik vrne HTTP 202, ga razlagajte v skladu s pogodbo te končne točke: sprejem zahteve sam po sebi ne pomeni dokončanega iskanja sledenja. Podobno HTTP 200 potrjuje, da je bila zahteva HTTP uspešna v skladu s semantiko te končne točke; ne dokazuje, da je vsako polje sledenja prisotno ali aktualno. Polja odgovorov, značilna za ponudnika, preslikajte šele po preverjanju dokumentacije ponudnika.
Naj bo napaka vidna operaterjem, ne da bi vznemirila stranke
Uporaben operativni zapis vključuje ID zahteve, končno točko ali operacijo, število poskusov, pretečeni čas, plast časovne prekoračitve, status HTTP, če je bil prejet, in podatek, ali je odgovor prišel iz iskanja v živo ali iz nadomestne možnosti. Pri podatkih o sledenju zabeležite vir ter ustrezne časovne žige dogodka ali pridobitve. Številke za sledenje in podatke o strankah obravnavajte v skladu s pravili svoje organizacije glede dostopa in hrambe; uporabnost diagnostike ni razlog za razkrivanje celotnih identifikatorjev v dnevnikih brez omejenega dostopa.
Opazujte vzorce, namesto da bi se zanašali na eno samo časovno prekoračitev. Naraščajoča stopnja časovnih prekoračitev na določeni poti prevoznika, ponavljajoči se odgovori 429 ali vse večja razlika med časom dogodka pri prevozniku in časom pridobitve lahko kažejo na različne težave. Prva lahko zahteva preiskavo ponudnika, druga nadzor hitrosti, tretja pa preverjanje sinhronizacije ali dostave dogodkov. Če aplikacija ponuja sledenje prek ponudnika, kot je 17TRACK Tracking API, pred uvedbo teh splošnih pravil uporabite dokumentacijo ponudnika za preverjanje polj odgovorov, omejitev zahtev in obravnave napak, značilnih za posamezne končne točke.
Pri sporočilu za stranko bodite natančni in zadržani: »Sledenja trenutno ni bilo mogoče osvežiti. Tukaj je najnovejša razpoložljiva posodobitev.« Po potrebi navedite naslednji korak, na primer naj uporabnik poskusi znova pozneje ali se obrne na podporo, če je pošiljka že zunaj pričakovanega roka dostave, ki ga je navedel prodajalec ali prevoznik. Ne obljubljajte časa osvežitve, ki ga vaš sistem ne more zagotoviti.
Kontrolni seznam za izdajo poteka sledenja, odpornega na časovne prekoračitve
- Potrdite, katera plast določa posamezno časovno omejitev in katera plast upravlja ponovne poskuse.
- Nastavite skupni rok zahteve in ločen, omejen proračun za ponovne poskuse.
- Preverite, ali je operacije, ki se samodejno ponavljajo, varno ponoviti.
- Upoštevajte omejitve hitrosti in veljavna navodila
Retry-After. - Izid zahteve shranite ločeno od statusa pošiljke in zgodovine dogodkov.
- Označite nadomestne podatke ter ohranite njihov vir in časovne žige, kadar so na voljo.
- Preizkusite scenarije brez predpomnilnika, z zastarelim predpomnilnikom, 429, 503, 504 in poznim odgovorom.
- Preverite, da časovna prekoračitev ne more sprožiti napačnega obvestila o dostavi ali izbrisati preverjenega dogodka.
Osnovno pravilo je preprosto: zahtevo ponovite le, kadar je to varno in koristno; uporabite nadomestno možnost le za informacije, ki jih lahko prepoznate; in nikoli ne oblikujte trditve o statusu pošiljke na podlagi časovne prekoračitve HTTP.
Pogosta vprašanja
Ali naj zahtevo za sledenje, ki je potekla, takoj ponovim?
Ne samodejno. Preverite, ali je operacijo varno ponoviti, ali skupni rok omogoča še en poskus in ali navodilo o omejitvi hitrosti zahteva čakanje. Kratek, omejen ponovni poskus z naključnim odmikom je lahko primeren za iskanje samo za branje; ponavljajoči se takojšnji poskusi niso dobra privzeta možnost.
Ali HTTP 504 pomeni, da sistem sledenja prevoznika ne deluje?
Ne. Pomeni, da prehod ali posredniški strežnik ni pravočasno prejel odgovora iz zaledne storitve. Težava je lahko kjer koli na tej poti zahteve. To ne potrjuje splošne razpoložljivosti prevoznika ali stanja paketa.
Ali lahko po časovni prekoračitvi prikažem zadnji znani status?
Da, če ga označite kot najnovejšo razpoložljivo informacijo in ne kot uspešno osvežitev v živo. Ko sta znana, prikažite čas dogodka in čas pridobitve ter jasno povejte, da novejše posodobitve ni bilo mogoče potrditi.
Ali mora časovna prekoračitev spremeniti status pošiljke iz »v tranzitu« v »izjema«?
Ne. Časovna prekoračitev je napaka zahteve, ne dogodek pošiljke. Status pošiljke spremenite le, ko zaupanja vreden vir sledenja zagotovi dogodek ali status, ki spremembo podpira.
Kaj pa, če je zahteva, ki je potekla, ustvarjala ali registrirala zapis sledenja?
Ne predpostavljajte, da je zahteva spodletela. Oddaljeni sistem jo je morda obdelal, preden je bil odgovor izgubljen. Pred ponovno predložitvijo preverite, ali že obstaja rezultat, in uporabite dokumentiran mehanizem idempotentnosti ali postopek obnovitve, ki ga je odobril ponudnik.
Viri
- RFC 9110, HTTP Semantics — opredelitve statusov HTTP,
Retry-Afterin vidiki ponavljanja zahtev. - RFC 6585, Additional HTTP Status Codes — opredelitev HTTP 429 in njegova uporaba s
Retry-After. - Amazon Builders’ Library, »Timeouts, retries, and backoff with jitter« — inženirske smernice o stopnjevanju ponovnih poskusov, umiku in naključnem odmiku.
- 17TRACK Tracking API documentation — referenca za preverjanje vedenja API-ja, značilnega za ponudnika, pred izvedbo.


