Skip to main content
KezdőlapBlogÚtmutatókIdőtúllépés történt a valós idejű nyomkövetési kérésnél? Az újrapróbálkozás, a tartalékmegoldás és az állapot követendő szabályai

Időtúllépés történt a valós idejű nyomkövetési kérésnél? Az újrapróbálkozás, a tartalékmegoldás és az állapot követendő szabályai

17TRACK

Amikor egy valós idejű nyomkövetési kérelem időtúllépés miatt meghiúsul, a küldemény legutóbbi állapotát ismeretlenként kell kezelni – nem késedelmesként, elveszettként vagy változatlanként. Csak korlátozott időkereten belül próbálkozz újra, majd jeleníts meg egy egyértelműen megjelölt, utolsó ismert frissítést, vagy kérd meg a felhasználót, hogy később próbálkozzon újra. A folyamat során mindig különítsd el a kérelem eredményét, az adatok frissességét és a csomag tényleges állapotát.

A valós idejű nyomkövetési kérelem időtúllépése, újrapróbálkozás, tartalékmegoldás és állapot

Ez a megkülönböztetés fontos mind az ügyfeleknek szóló nyomkövetési oldalak, mind azok a rendszerek esetében, amelyek értesítések vagy támogatási munkafolyamatok elindítására használják a nyomkövetési adatokat. Az időtúllépés azt jelzi, hogy a válasz nem érkezett meg időben. Nem derül ki belőle, hogy a fuvarozónál történt-e új esemény, egy upstream szolgáltatás feldolgozta-e a kérelmet, vagy a csomag elmozdult-e.

17TRACK API
Egyszerűsítsd a globális csomagkövetést több mint 3500 fuvarozó küldeményfrissítéseivel. További információ

Először azonosítsd, mi lépett túl az időkorláton

Egy nyomkövetési kérelem több ponton is meghiúsulhat: a böngésző abbahagyhatja az alkalmazás válaszára való várakozást, az alkalmazás abbahagyhatja a nyomkövetési API válaszára való várakozást, vagy az API időtúllépést tapasztalhat egy másik szolgáltatással való kapcsolatfelvétel közben. A felhasználó mindhárom esetben ugyanazt az általános hibaüzenetet láthatja, de a megfelelő következő lépés eltérő.

Branded Order Tracking Solution
Nyújts jobb ügyfélélményt és ösztönözz több visszatérő vásárlást márkázott nyomkövetéssel és automatizált értesítésekkel. Ingyenes kipróbálás

  • Kliensoldali időtúllépés: Az alkalmazás abbahagyta a várakozást. A szerveroldali kérelem ettől még befejeződhetett. Új, esetlegesen ismételt munkát létrehozó kérelem indítása előtt ellenőrizd a saját kérésnaplóidat vagy eredménytárolódat.
  • Hálózati vagy kapcsolati hiba: A rendszered nem kapott használható választ. Nem biztos, hogy tudod, feldolgozta-e a távoli szolgáltatás a kérelmet.
  • HTTP 504: Egy átjáró vagy proxy nem kapott időben választ egy upstream szervertől. Ez a kérelem útvonalát írja le, nem a küldeményt.
  • HTTP 408: A szerver nem kapott teljes kérelemüzenetet azon időn belül, ameddig készen állt várakozni. Ez nem fuvarozói nyomkövetési állapot.
  • HTTP 200 régi eseménnyel: A kérelem sikeres volt, de a visszaadott nyomkövetési információ továbbra is elavult lehet. A sikeres HTTP-válasz nem garantálja az adatok frissességét.

Ezeket az eredményeket kérésdiagnosztikaként rögzítsd. Egyiket se fordítsd le olyan küldeményállapot-címkékre, mint „szállítás alatt”, „kivétel” vagy „kézbesítve”. Ezeknek a címkéknek nyomkövetési eseményekből vagy dokumentált állapotmezőből kell származniuk, nem az átviteli rétegből.

Használj korlátozott újrapróbálkozást, ne végtelen ciklust

Csak olvasási célú nyomkövetési lekérdezés esetén gyakran ésszerű az időtúllépés utáni újrapróbálkozás. Ennek azonban korlátozottnak kell lennie. Az ismételt kérelmek növelhetik a nehézségekkel küzdő szolgáltatás terhelését, meghosszabbíthatják a felhasználó várakozását, és ismételt munkát hozhatnak létre, ha több alkalmazási réteg egymástól függetlenül próbálkozik újra.

  1. Állíts be teljes határidőt. Döntsd el, mennyi ideig tarthat a felhasználó számára látható művelet, beleértve az első próbálkozást és az esetleges újrapróbálkozást. Ne adj minden próbálkozásnak új, teljes határidőt, amely meghaladja azt az időt, ameddig a hívó fél várni tud.
  2. Ellenőrizd, hogy a művelet biztonságosan megismételhető-e. A lekérdezés általában eltér egy küldeményt regisztráló, beállításokat módosító vagy erőforrást létrehozó kéréstől. Állapotot módosító kérelmet ne játssz le automatikusan újra, kivéve, ha a szolgáltató szerződése vagy az idempotenciát biztosító vezérlőid ezt biztonságossá teszik.
  3. Az átmeneti hibát takarékosan próbáld újra. Használj kis, kifejezetten meghatározott újrapróbálkozási keretet és jitterrel kiegészített késleltetést ahelyett, hogy sok kliens egyszerre, azonnal újrapróbálkozna.
  4. Tartsd be a szerver utasításait. Ha a válasz érvényes Retry-After fejlécet tartalmaz, ne ütemezz korábbi újrapróbálkozást. Tartsd be a szigorúbb alkalmazási vagy szolgáltatóspecifikus korlátokat is.
  5. Állj le, amikor lejár a határidő vagy kimerül a keret. Válts tartalék választásra, és ha a munkafolyamat megkívánja, ütemezz külön későbbi egyeztetést.

Gyakorlati megoldásként engedélyezhetsz egy, a felhasználó számára látható újrapróbálkozást, ha még van elegendő idő, a további próbálkozásokat pedig háttérben futó frissítésre helyezheted át. Ez egy szabályzati példa, nem általános API-szabály. A korlátokat a szolgáltatási célok, a megfigyelt késleltetés és a szolgáltató dokumentációja alapján válaszd meg. Számítsd bele a HTTP-könyvtárak, átjárók és munkafeldolgozók által végzett újrapróbálkozásokat is; ellenkező esetben egy szerénynek tűnő alkalmazási szabály sok upstream hívást eredményezhet.

HTTP 429 esetén a választ sebességkorlátozási jelzésként kezeld, ne azonnali újrapróbálkozás okaként. A HTTP 503 a kérelem ideiglenes feldolgozási képtelenségét jelezheti, és a szerver Retry-After értéket adhat meg. A 504 lehet átmeneti, de nem garantálja, hogy a következő próbálkozás sikeres lesz. A hitelesítési hibák általában a hitelesítő adatok vagy jogosultságok ellenőrzését igénylik, míg a hibás kérelmek bemeneti javítást. A „nem található” eredményt adó nyomkövetési azonosító nagyobb körültekintést igényel: a szolgáltató dokumentált működésétől és a küldemény szakaszától függően lehet, hogy még túl korai a rekord megtalálásához, vagy hibás az azonosító. Ne alakítsd egyetlen ilyen eredményt végleges állítássá arról, hogy a csomag nem létezik.

Olyan tartalékmegoldást válassz, amely megőrzi, amit tudunk

A legbiztonságosabb tartalékmegoldás általában az utolsó ellenőrzött nyomkövetési eredmény, a saját eseményidejével és őszinte frissességi címkéjével együtt. Ezt az eredményt különítsd el az aktuális kérelem hibájától. Egy oldal például ezt írhatja: „Legutóbbi elérhető frissítés: Elhagyta a létesítményt. Utolsó ellenőrzés: [idő]. Újabb frissítés átmenetileg nem érhető el.” Az „Utolsó ellenőrzés” csak akkor jelenjen meg, ha a rendszer ténylegesen rögzíti; ez nem helyettesíti a fuvarozói esemény idejét.

A lehető legpontosabb időt használd, amelyet alá tudsz támasztani. A fuvarozói esemény ideje azt jelzi, mikor történt állítólag az esemény. Az az időpont, amikor a rendszered fogadta az eseményt, a beérkezés idejét jelzi. Az az időpont, amikor a felhasználó megnyitotta az oldalt, egyiket sem jelenti. Ha a forrás nem biztosít megbízható eseményidőt vagy időzónát, ne találj ki egyet. Hasonlóképpen, ha a gyorsítótárazott eredményhez nincs rögzített lekérési idő, „legutóbbi elérhető frissítésnek” nevezd, és ne állítsd, hogy nemrég frissült.

A tartalékmegoldásnak három határt kell követnie:

  • A gyorsítótárazott adatot gyorsítótárazott adatként jelenítsd meg. Ne tüntess fel egy régebbi eseményt az időtúllépés miatt meghiúsult kérelem eredményeként.
  • Ne következtess előrehaladásra az eltelt időből. Egy csomag nem lesz pusztán azért „kézbesítés alatt”, mert több napja szállítás alatt van.
  • Ne rejtsd el a lényeges bizonytalanságot. Ha nincs korábbi eredmény, mondd azt, hogy a nyomkövetés átmenetileg nem érhető el, ahelyett hogy kitalált alapértelmezett állapotot jelenítenél meg.

További tartalékútvonal lehet egy korábban szinkronizált nyomkövetési tár, egy engedélyezett fuvarozói lekérdezés vagy egy későbbi háttérfrissítés. Csak akkor használd ezeket, ha megfelelnek a küldeménynek, a jogosultságaidnak és az adatforrás feltételeinek. Egy második forrás eltérő eseményneveket vagy jelentési késéseket alkalmazhat, ezért őrizd meg az eredetet, és ne egyesítsd az egymásnak ellentmondó rekordokat anélkül, hogy rendelkeznél erre vonatkozó szabállyal. Ha az ügyfél a kapott eredmény alapján cselekedhet, biztosíts lehetőséget az újrapróbálkozásra vagy az ügyfélszolgálat megkeresésére, ahelyett hogy végtelen ideig töltőjelzőt jelenítenél meg.

Tartsd külön a kérelem állapotát, az adatok frissességét és a küldemény állapotát

Ez három különböző mező, még akkor is, ha a felhasználói felület együtt jeleníti meg őket. A kérelem állapota azt jelzi, hogy a lekérdezés sikeres volt-e, időtúllépéssel meghiúsult-e, vagy hibát kapott-e. Az adatok frissessége azt jelzi, mikor figyelték meg a visszaadott vagy tárolt információt. A küldemény állapota azt jelzi, mit közöl a nyomkövetési forrás a csomagról. Elkülönítésük megakadályozza, hogy egy ideiglenes API-hiba felülírjon egy érvényes kézbesítési eseményt, vagy egy elavult, szállítás alatt állapot aktuális állítássá váljon.

Például a rendszer egy korábbi lekérdezésből származó, ellenőrzött „Kézbesítve” eseményt tarthat nyilván, miközben az aktuális frissítés időtúllépéssel meghiúsul. A kézbesítési esemény nem tűnik el. A helyes együttes állapot az, hogy a legutóbbi elérhető küldeményállapot kézbesítve, a legújabb frissítés pedig sikertelen. Ezzel szemben ha az utolsó esemény „Szállítás alatt”, az időtúllépés nem erősíti meg, hogy a csomag ebben a pillanatban is úton van; csak azt erősíti meg, hogy nem érkezett újabb válasz.

Alkalmazz meghatározott szabályt, amikor az események nem időrendben érkeznek. Ha lehetséges, hasonlítsd össze az eseményazonosítókat, az időbélyegeket, a forrást és a szolgáltató dokumentált állapotjelentéseit. Ne feltételezd, hogy a rendszered által fogadott frissítések sorrendje megegyezik a küldeményesemények sorrendjével. Egy későn érkező, régebbi esemény sem írhatja felül automatikusan az újabb, ellenőrzött állapotot. Javítások és kivételek azonban jogosak lehetnek, ezért ne alkalmazz általános szabályt, amely lehetetlennek tekinti a kézbesítés utáni állapotváltozásokat. Őrizd meg az alapul szolgáló eseményeket, és vizsgáld ki az ellentmondásokat ahelyett, hogy csendben átírnád az előzményeket.

Ha egy szolgáltató HTTP 202 választ ad, azt az adott végpont szerződése szerint értelmezd: a kérelem elfogadása önmagában nem jelenti a nyomkövetési lekérdezés befejezését. Hasonlóképpen a HTTP 200 azt igazolja, hogy a HTTP-kérelem sikeres volt az adott végpont jelentése szerint; nem bizonyítja, hogy minden nyomkövetési mező jelen van vagy aktuális. A szolgáltatóspecifikus válaszmezőket csak a szolgáltató dokumentációjának ellenőrzése után képezd le.

17RETURNS
Egyszerűsítsd a visszaküldéseket és cseréket, hogy csökkentsd a DTC-ügyfélszolgálat terhelését és a bevételkiesést. További információ

Tedd láthatóvá a hibát az üzemeltetők számára anélkül, hogy riadalmat keltenél az ügyfelekben

Egy hasznos üzemeltetési rekord tartalmazza a kérésazonosítót, a végpontot vagy műveletet, a próbálkozások számát, az eltelt időt, az időtúllépési réteget, a kapott HTTP-állapotot, valamint azt, hogy a válasz élő lekérdezésből vagy tartalékmegoldásból származott-e. A nyomkövetési adatoknál rögzítsd a forrást és a releváns esemény- vagy lekérési időbélyegeket. A nyomkövetési számokat és az ügyféladatokat a szervezet hozzáférési és megőrzési szabályai szerint kezeld; a diagnosztikai hasznosság nem indokolja a teljes azonosítók korlátozás nélküli naplókban való megjelenítését.

Ne egyetlen időtúllépésre támaszkodj, hanem figyeld a mintázatokat. Egy fuvarozói útvonal növekvő időtúllépési aránya, az ismétlődő 429-es válaszok vagy a fuvarozói esemény ideje és a lekérési idő közötti növekvő különbség eltérő problémákra utalhat. Az első szolgáltatói vizsgálatot, a második sebességszabályozást, a harmadik pedig a szinkronizálás vagy az eseménytovábbítás ellenőrzését teheti szükségessé. Ha egy alkalmazás olyan szolgáltatón keresztül biztosít nyomkövetést, mint a 17TRACK Tracking API, az általános szabályok bevezetése előtt a szolgáltató dokumentációjával ellenőrizd a végpontspecifikus válaszmezőket, kéréskorlátokat és hibakezelést.

Az ügyfélnek szóló üzenet legyen pontos és visszafogott: „Most nem sikerült frissítenünk a nyomkövetést. Itt látható a legutóbbi elérhető frissítés.” Adj következő lépést, amikor hasznos, például azt, hogy később próbálkozzon újra, vagy keresse az ügyfélszolgálatot, ha a küldemény túllépte az eladó vagy a fuvarozó által megadott várható kézbesítési időt. Ne ígérj olyan frissítési időt, amelyet a rendszered nem tud garantálni.

Ellenőrzőlista időtúllépés-biztos nyomkövetési folyamat kiadásához

  • Ellenőrizd, melyik réteg írja elő az egyes időtúllépéseket, és melyik réteg kezeli az újrapróbálkozásokat.
  • Állíts be teljes kéréshatáridőt és külön, korlátozott újrapróbálkozási keretet.
  • Ellenőrizd, hogy az automatikusan újrapróbált műveletek biztonságosan megismételhetők-e.
  • Tartsd be a sebességkorlátokat és az érvényes Retry-After utasításokat.
  • A kérelem eredményét külön tárold a küldemény állapotától és eseménytörténetétől.
  • Címkézd a tartalékadatokat, és amikor lehetséges, őrizd meg a forrásukat és időbélyegeiket.
  • Teszteld a gyorsítótár nélküli, elavult gyorsítótáras, 429-es, 503-as, 504-es és késői válasszal járó helyzeteket.
  • Ellenőrizd, hogy egy időtúllépés ne indítson hibás kézbesítési értesítést, és ne töröljön ellenőrzött eseményt.

Az alapelv egyszerű: csak akkor próbálj újra egy kérelmet, ha ez biztonságos és hasznos; csak olyan információra támaszkodj tartalékmegoldásként, amelyet azonosítani tudsz; és soha ne tegyél állítást a küldemény állapotáról egy HTTP-időtúllépés alapján.

GYIK

Azonnal újra kell próbálnom az időtúllépéssel meghiúsult nyomkövetési kérelmet?

Nem automatikusan. Ellenőrizd, hogy a művelet biztonságosan megismételhető-e, hogy az általános határidő elegendő időt hagy-e egy újabb próbálkozásra, és hogy nincs-e várakozást előíró sebességkorlátozási utasítás. Csak olvasási célú lekérdezés esetén megfelelő lehet egy rövid, korlátozott, jitterrel kiegészített újrapróbálkozás; az ismételt azonnali próbálkozás rossz alapértelmezés.

A HTTP 504 azt jelenti, hogy a fuvarozó nyomkövetési rendszere nem működik?

Nem. Azt jelenti, hogy egy átjáró vagy proxy nem kapott időben upstream választ. A probléma a kérelem útvonalának bármely pontján jelentkezhet. Ez nem bizonyítja sem a fuvarozó általános elérhetetlenségét, sem a csomag állapotát.

Megjeleníthetem az utolsó ismert állapotot időtúllépés után?

Igen, ha a sikeres élő frissítés helyett a legutóbbi elérhető információként címkézed. Jelenítsd meg az esemény idejét és a lekérés idejét, ha ismertek, és tedd egyértelművé, hogy újabb frissítést nem sikerült megerősíteni.

Az időtúllépésnek a „szállítás alatt” állapotot „kivétel” állapotra kell változtatnia?

Nem. Az időtúllépés kérelemhiba, nem küldeményesemény. A küldemény állapotát csak akkor módosítsd, amikor egy megbízható nyomkövetési forrás olyan eseményt vagy állapotot szolgáltat, amely alátámasztja a változást.

Mi van akkor, ha az időtúllépéssel meghiúsult kérelem nyomkövetési rekordot hozott létre vagy regisztrált?

Ne feltételezd, hogy meghiúsult. A távoli rendszer feldolgozhatta a kérelmet, mielőtt a válasz elveszett. Újraküldés előtt ellenőrizd, hogy létezik-e már eredmény, és használj dokumentált idempotenciamechanizmust vagy a szolgáltató által jóváhagyott helyreállítási eljárást.

Források