Skip to main content
ПочетакБлогVodičiIsteklo je vreme zahteva za praćenje u realnom vremenu? Pravila za ponovni pokušaj, rezervni mehanizam i status koja treba slediti

Isteklo je vreme zahteva za praćenje u realnom vremenu? Pravila za ponovni pokušaj, rezervni mehanizam i status koja treba slediti

17TRACK

Kada zahtev za praćenje u realnom vremenu istekne, najnoviji status pošiljke tretirajte kao nepoznat — ne kao zakašnjenje, gubitak ili nepromenjen status. Ponovite zahtev samo u okviru ograničenog vremenskog budžeta, a zatim prikažite jasno označenu poslednju poznatu informaciju ili zatražite od korisnika da pokuša ponovo kasnije. Tokom celog procesa odvojeno tretirajte ishod zahteva, svežinu podataka i stvarni status paketa.

Istek zahteva za praćenje u realnom vremenu, ponovni pokušaj, rezervna opcija i status

Ovo razlikovanje je važno i za stranice za praćenje namenjene korisnicima i za sisteme koji koriste podatke o praćenju za pokretanje obaveštenja ili tokova rada korisničke podrške. Istek zahteva govori da odgovor nije stigao na vreme. Ne govori da li prevoznik ima novi događaj, da li je uzvodna usluga obradila zahtev ili da li se paket pomerio.

Prvo utvrdite šta je isteklo

Zahtev za praćenje može da ne uspe na nekoliko mesta: pregledač može prestati da čeka vašu aplikaciju, vaša aplikacija može prestati da čeka API za praćenje ili taj API može isteći dok kontaktira drugu uslugu. Korisnik u svakom slučaju može videti istu opštu grešku, ali se odgovarajuća naredna radnja razlikuje.

  • Istek na strani klijenta: Aplikacija je prestala da čeka. Zahtev na strani servera je možda ipak završen. Proverite sopstvene dnevnike zahteva ili skladište rezultata pre nego što pošaljete novi zahtev koji bi mogao da duplira posao.
  • Mrežni ili povezani kvar: Vaš sistem nije primio upotrebljiv odgovor. Možda nećete znati da li je udaljena usluga obradila zahtev.
  • HTTP 504: Mrežni prolaz ili proksi nije na vreme primio odgovor od uzvodnog servera. Ovo opisuje putanju zahteva, a ne pošiljku.
  • HTTP 408: Server nije primio kompletnu poruku zahteva u roku u kojem je bio spreman da čeka. To nije status praćenja kod prevoznika.
  • HTTP 200 sa starim događajem: Zahtev je uspeo, ali vraćene informacije o praćenju i dalje mogu biti zastarele. Uspešan HTTP odgovor nije garancija svežine.

Ove ishode evidentirajte kao dijagnostiku zahteva. Nemojte nijedan od njih prevoditi u oznake pošiljke kao što su „u tranzitu“, „izuzetak“ ili „isporučeno“. Te oznake treba da potiču iz događaja praćenja ili dokumentovanog polja statusa, a ne iz transportnog sloja.

Koristite ograničeni ponovni pokušaj, a ne petlju bez kraja

Za praćenje koje samo čita podatke, ponovni pokušaj nakon isteka često je razuman. Ipak, treba da bude ograničen. Ponovljeni zahtevi mogu povećati opterećenje usluge koja ima probleme, produžiti čekanje korisnika i stvoriti duplirani posao kada više slojeva aplikacije nezavisno ponavlja zahteve.

  1. Postavite ukupan rok. Odredite koliko dugo operacija namenjena korisniku može da traje, uključujući početni pokušaj i svaki ponovni pokušaj. Nemojte svakom pokušaju dodeliti novi, puni rok koji premašuje vreme tokom kojeg pozivalac može da čeka.
  2. Proverite da li je operacija bezbedna za ponavljanje. Uobičajeno traženje podataka razlikuje se od zahteva koji registruje pošiljku, menja podešavanja ili kreira resurs. Nemojte automatski ponavljati zahtev koji menja stanje osim ako ugovor dobavljača ili vaše kontrole idempotentnosti to čine bezbednim.
  3. Štedljivo ponovite privremeni kvar. Koristite mali, izričito definisan budžet za ponovne pokušaje i kašnjenje sa slučajnim odstupanjem, umesto da mnogi klijenti istovremeno šalju neposredne ponovne pokušaje.
  4. Poštujte primenljiva uputstva servera. Ako odgovor uključuje važeće zaglavlje Retry-After, nemojte zakazati raniji ponovni pokušaj. Takođe poštujte svako strože ograničenje aplikacije ili dobavljača.
  5. Zaustavite se kada rok ili budžet isteknu. Pređite na rezervni odgovor i zasebno zakažite kasniju usaglašavanje ako je vašem toku rada potrebno.

Praktičan dizajn može dozvoliti jedan ponovni pokušaj namenjen korisniku ako ima dovoljno preostalog vremena, dok se dalji pokušaji premeštaju u pozadinsko osvežavanje. To je primer politike, a ne univerzalno pravilo API-ja. Ograničenja izaberite na osnovu ciljeva nivoa usluge, uočene latencije i dokumentacije dobavljača. Takođe uračunajte ponovne pokušaje koje obavljaju HTTP biblioteke, mrežni prolazi i radnici poslova; u suprotnom naizgled umerena politika aplikacije može proizvesti mnogo uzvodnih poziva.

Za HTTP 429 tretirajte odgovor kao signal ograničenja brzine, a ne kao razlog za neposredni ponovni pokušaj. HTTP 503 može ukazivati na privremenu nemogućnost obrade zahteva, a server može proslediti Retry-After. 504 može biti privremen, ali ne garantuje da će sledeći pokušaj uspeti. Greške autentifikacije uglavnom zahtevaju proveru akreditiva ili dozvola, dok neispravni zahtevi zahtevaju ispravku unosa. Identifikator praćenja koji daje rezultat „nije pronađeno“ zahteva veću pažnju: u zavisnosti od dokumentovanog ponašanja dobavljača i faze pošiljke, možda je prerano da se pronađe zapis ili je identifikator pogrešan. Nemojte jedan takav rezultat pretvoriti u konačnu tvrdnju da paket ne postoji.

Izaberite rezervnu opciju koja čuva ono što znate

Najbezbednija rezervna opcija obično je poslednji potvrđeni rezultat praćenja, zajedno sa sopstvenim vremenom događaja i iskrenom oznakom svežine. Taj rezultat držite odvojenim od trenutnog neuspeha zahteva. Stranica može reći: „Najnovije dostupno ažuriranje: Objekat napušten. Poslednja provera: [vreme]. Novije ažuriranje trenutno nije dostupno.“ Uključite „Poslednja provera“ samo ako ga vaš sistem zaista beleži; ono nije zamena za vreme događaja prevoznika.

Koristite najpreciznije vreme koje možete potkrepiti. Vreme događaja prevoznika opisuje kada se događaj navodno dogodio. Vreme kada je vaš sistem primio taj događaj opisuje preuzimanje. Vreme kada je korisnik otvorio stranicu ne opisuje ni jedno ni drugo. Ako izvor ne pruža pouzdano vreme događaja ili vremensku zonu, nemojte je izmišljati. Isto tako, ako keširani rezultat nema zabeleženo vreme preuzimanja, nazovite ga „poslednje dostupno ažuriranje“, umesto da tvrdite da je nedavno osvežen.

Rezervna opcija treba da poštuje tri granice:

  • Prikažite keširane podatke kao keširane podatke. Nemojte stariji događaj predstaviti kao rezultat zahteva koji je istekao.
  • Ne zaključujte napredak na osnovu proteklog vremena. Paket nije „na dostavi“ samo zato što je nekoliko dana u tranzitu.
  • Ne prikrivajte značajnu neizvesnost. Ako nema prethodnog rezultata, recite da je praćenje privremeno nedostupno, umesto da prikažete izmišljeni podrazumevani status.

Drugi putevi rezervne opcije mogu uključivati prethodno sinhronizovano skladište praćenja, ovlašćeno pretraživanje kod prevoznika ili kasnije osvežavanje u pozadini. Koristite ih samo ako odgovaraju pošiljci, vašim dozvolama i uslovima izvora podataka. Drugi izvor može imati drugačije nazive događaja ili kašnjenja u izveštavanju, zato sačuvajte poreklo podataka i izbegavajte spajanje suprotstavljenih zapisa bez pravila za takvo postupanje. Ako korisnik može da preduzme radnju na osnovu rezultata, omogućite ponovni pokušaj ili kontakt sa podrškom, umesto da beskonačno ostavljate indikator učitavanja.

Odvojeno tretirajte status zahteva, svežinu podataka i status pošiljke

To su tri različita polja, čak i kada ih korisnički interfejs prikazuje zajedno. Status zahteva govori da li je pretraga uspela, istekla ili primila grešku. Svežina podataka govori kada su vraćene ili sačuvane informacije uočene. Status pošiljke govori šta izvor praćenja prijavljuje o paketu. Njihovo razdvajanje sprečava da privremeni kvar API-ja prepiše važeći događaj isporuke ili da zastareli događaj „u tranzitu“ pretvori u trenutnu tvrdnju.

Na primer, sistem može sadržati potvrđeni događaj „Isporučeno“ iz ranije pretrage dok trenutno osvežavanje ističe. Događaj isporuke ne nestaje. Ispravno objedinjeno stanje jeste da je poslednji dostupan status pošiljke „isporučeno“, a da je najnovije osvežavanje neuspešno. Obrnuto, ako je poslednji događaj „U tranzitu“, istek ne potvrđuje da paket u ovom trenutku ostaje u tranzitu; potvrđuje samo da nije dobijen noviji odgovor.

Primeni­te definisano pravilo kada događaji stignu van redosleda. Gde je dostupno, uporedite identifikatore događaja, vremenske oznake, izvor i dokumentovanu semantiku statusa dobavljača. Nemojte pretpostaviti da je redosled kojim je vaš sistem primio ažuriranja isti kao redosled kojim su se događaji pošiljke dogodili. Takođe, kasnije pristigli stariji događaj ne treba automatski da zameni noviji potvrđeni status. Ispravke i izuzeci ipak mogu biti legitimni, zato izbegavajte opšte pravilo koje promene statusa nakon isporuke tretira kao nemoguće. Sačuvajte osnovne događaje i istražite protivrečnosti umesto da nečujno prepisujete istoriju.

Ako dobavljač vrati HTTP 202, tumačite ga u skladu sa ugovorom te krajnje tačke: prihvatanje zahteva samo po sebi nije završena pretraga praćenja. Slično tome, HTTP 200 potvrđuje da je HTTP zahtev uspeo prema semantici te krajnje tačke; ne dokazuje da je svako polje praćenja prisutno ili ažurno. Polja odgovora specifična za dobavljača mapirajte tek nakon provere njegove dokumentacije.

Učinite kvar vidljivim operaterima, bez uznemiravanja korisnika

Korisna operativna evidencija uključuje ID zahteva, krajnju tačku ili operaciju, broj pokušaja, proteklo vreme, sloj u kojem je došlo do isteka, HTTP status ako je primljen i informaciju da li je odgovor došao iz aktivne pretrage ili rezervne opcije. Za podatke o praćenju zabeležite izvor i relevantne vremenske oznake događaja ili preuzimanja. Brojevima za praćenje i informacijama o korisnicima rukujte u skladu sa pravilima vaše organizacije o pristupu i čuvanju podataka; dijagnostička korisnost nije razlog da se puni identifikatori izlažu u neograničenim dnevnicima.

Pratite obrasce umesto da se oslanjate na jedan istek. Povećanje broja isteka na jednoj ruti prevoznika, ponovljeni odgovori 429 ili sve veći jaz između vremena događaja prevoznika i vremena preuzimanja mogu ukazivati na različite probleme. Prvi može zahtevati istragu dobavljača, drugi kontrolu brzine, a treći proveru sinhronizacije ili isporuke događaja. Ako aplikacija nudi praćenje preko dobavljača kao što je 17TRACK Tracking API, koristite dokumentaciju tog dobavljača da proverite polja odgovora specifična za krajnju tačku, ograničenja zahteva i obradu grešaka pre primene ovih opštih pravila.

Poruka namenjena korisniku treba da bude precizna i odmerena: „Trenutno nismo mogli da osvežimo praćenje. Evo najnovijeg dostupnog ažuriranja.“ Navedite sledeći korak kada je korisno, na primer da korisnik pokuša ponovo kasnije ili kontaktira podršku ako je pošiljka prekoračila očekivani rok isporuke koji je naveo prodavac ili prevoznik. Izbegavajte obećavanje vremena osvežavanja koje vaš sistem ne može da garantuje.

Kontrolna lista za objavljivanje toka praćenja bezbednog pri isteku

  • Potvrdite koji sloj nameće svaki rok i koji sloj upravlja ponovnim pokušajima.
  • Postavite ukupan rok zahteva i zaseban, ograničen budžet za ponovne pokušaje.
  • Proverite da li su operacije koje se automatski ponavljaju bezbedne za ponavljanje.
  • Poštujte ograničenja brzine i važeća uputstva Retry-After.
  • Čuvajte ishod zahteva odvojeno od statusa pošiljke i istorije događaja.
  • Označite rezervne podatke i sačuvajte njihov izvor i vremenske oznake kada su dostupni.
  • Testirajte scenarije bez keša, sa zastarelim kešom, 429, 503, 504 i zakašnjelim odgovorom.
  • Proverite da istek ne može da pokrene netačno obaveštenje o isporuci ili izbriše potvrđeni događaj.

Osnovno pravilo je jednostavno: ponovite zahtev samo kada je to bezbedno i korisno; koristite rezervnu opciju samo za informacije koje možete identifikovati; i nikada ne izvodite tvrdnju o statusu pošiljke iz HTTP isteka.

Česta pitanja

Da li treba odmah da ponovim zahtev za praćenje koji je istekao?

Ne automatski. Proverite da li je operacija bezbedna za ponavljanje, da li ukupni rok ostavlja vremena za još jedan pokušaj i da li uputstvo o ograničenju brzine nalaže čekanje. Kratak, ograničen ponovni pokušaj sa slučajnim odstupanjem može biti prikladan za pretragu koja samo čita podatke; ponovljeni neposredni pokušaji nisu dobro podrazumevano ponašanje.

Da li HTTP 504 znači da sistem za praćenje prevoznika ne radi?

Ne. To znači da mrežni prolaz ili proksi nije na vreme primio uzvodni odgovor. Problem može biti bilo gde duž te putanje zahteva. To ne potvrđuje opštu dostupnost prevoznika niti stanje paketa.

Mogu li da prikažem poslednji poznati status nakon isteka?

Da, ako ga označite kao najnoviju dostupnu informaciju, a ne kao uspešno aktivno osvežavanje. Prikažite vreme događaja i vreme preuzimanja kada su poznati i jasno navedite da novije ažuriranje nije moglo biti potvrđeno.

Da li istek treba da promeni pošiljku iz statusa „u tranzitu“ u „izuzetak“?

Ne. Istek je neuspeh zahteva, a ne događaj pošiljke. Status pošiljke menjajte samo kada pouzdan izvor praćenja dostavi događaj ili status koji podržava tu promenu.

Šta ako je zahtev koji je istekao kreirao ili registrovao zapis praćenja?

Nemojte pretpostaviti da nije uspeo. Udaljeni sistem ga je možda obradio pre nego što je odgovor izgubljen. Proverite da li postoji postojeći rezultat i koristite dokumentovani mehanizam idempotentnosti ili postupak oporavka koji je odobrio dobavljač pre nego što ga ponovo pošaljete.

Izvori