Skip to main content
AcasăBlogGhiduri7 moduri de a configura frecvența actualizărilor de urmărire: date mai proaspete, mai puține solicitări API

7 moduri de a configura frecvența actualizărilor de urmărire: date mai proaspete, mai puține solicitări API

17TRACK

Configurați frecvența actualizărilor de urmărire stabilind un obiectiv de prospețime, variind interogarea în funcție de starea expedierii, utilizând webhook-uri acolo unde sunt acceptate, reconciliind actualizările omise, memorând în cache rezultatele partajate, grupând lucrările programate și reducând frecvența în timpul erorilor sau al limitelor de rată. Pentru dezvoltatori și echipele operaționale, obiectivul nu este cel mai scurt interval posibil, ci să transmită în sistemele proprii modificările utile ale expedierilor fără a solicita în mod repetat date neschimbate.

7 modalități de configurare a frecvenței actualizărilor de urmărire Date mai proaspete mai puține

Aceste controale aparțin de obicei aplicației care conectează furnizorul de urmărire la un sistem de gestionare a comenzilor, o platformă de asistență sau o pagină de urmărire destinată clienților. Unii furnizori oferă, de asemenea, propriile controale de reîmprospătare. Păstrați separate aceste două niveluri: modificarea programului de solicitări al aplicației nu schimbă neapărat frecvența cu care un furnizor verifică transportatorul.

Mai întâi, identificați frecvența actualizărilor pe care o puteți controla

O actualizare a expedierii trece prin mai multe etape înainte ca un client să o vadă. Un transportator înregistrează un eveniment, un serviciu de urmărire îl obține, aplicația dvs. îl primește sau îl recuperează, iar interfața dvs. îl afișează. Întârzierile în orice etapă pot face ca urmărirea să pară învechită.

  • Disponibilitatea evenimentului transportatorului: Momentul în care transportatorul înregistrează și publică o scanare sau o modificare de stare.
  • Frecvența reîmprospătării furnizorului: Momentul în care un serviciu de urmărire verifică sau primește informații de la transportator.
  • Frecvența recuperării de către aplicație: Momentul în care sistemul dvs. solicită informații sau procesează notificări primite.
  • Frecvența reîmprospătării afișării: Momentul în care site-ul, aplicația sau instrumentul de asistență își reîmprospătează vizualizarea locală.

Interogarea mai frecventă a unui furnizor poate reduce a treia întârziere. Nu poate garanta o scanare mai nouă a transportatorului și nici nu poate forța o reîmprospătare în amonte, cu excepția cazului în care un endpoint documentat efectuează explicit această acțiune. Înainte de a modifica un program, stabiliți dacă o solicitare API citește date de urmărire stocate, inițiază o reîmprospătare sau efectuează altceva.

Pentru o integrare 17TRACK, începeți cu prezentarea generală a Tracking API și documentația oficială API. Confirmați comportamentul operațiunilor pe care intenționați să le utilizați, inclusiv livrarea actualizărilor, limitele solicitărilor și orice controale de reîmprospătare. Modelele de programare de mai jos sunt recomandări la nivelul aplicației, nu o afirmație că fiecare interval este o setare configurabilă 17TRACK.

1. Stabiliți un obiectiv de prospețime înainte de a alege un interval

Definiți cât de repede trebuie să afle fiecare flux de lucru despre un eveniment nou disponibil. O coadă pentru excepții de livrare poate justifica un obiectiv mai strict decât un tablou de bord istoric al expedierilor. Atribuirea aceluiași interval de interogare ambelor fluxuri irosește solicitări sau lasă fluxul mai urgent insuficient deservit.

Separați două măsurători: timpul de la ultima recuperare reușită și vechimea celui mai recent eveniment al expedierii. O solicitare reușită poate returna un eveniment vechi deoarece nu s-a schimbat nimic. Acest lucru diferă de o integrare eșuată care nu a recuperat date recent.

Utilizați o politică de configurare redusă în loc să introduceți intervale în întregul cod:

  • Obiectiv de prospețime: Întârzierea acceptabilă dintre disponibilitatea la furnizor și ingestia în aplicație.
  • Interval normal de interogare: Intervalul implicit pentru expedierile eligibile.
  • Interval maxim de reconciliere: Cât timp poate trece o expediere fără o verificare reușită.
  • Buget de solicitări: Capacitatea disponibilă după contabilizarea reîncercărilor, reconcilierii și altor operațiuni API.

Ca exemplu de planificare, verificarea individuală a 12.000 de expedieri în fiecare oră ar genera 288.000 de solicitări de căutare programate pe zi, înainte de reîncercări. Verificarea lor la fiecare patru ore ar genera 72.000. Acestea sunt calcule ilustrative, nu limite ale furnizorului sau intervale recomandate; gruparea și livrarea push ar schimba calculul.

Alegeți cel mai lung interval care îndeplinește obiectivul de prospețime al fluxului de lucru, apoi testați dacă datele din amonte sunt suficient de recente pentru ca intervalul respectiv să fie util.

2. Modificați intervalul pe măsură ce expedierea își schimbă starea

Un singur program ignoră modul în care se comportă expedierile. Un colet care așteaptă prima scanare, unul care parcurge un segment lung de transport și unul care se apropie de livrare nu necesită neapărat aceeași atenție.

Condiția expedieriiAbordare de programare sugeratăMăsură de protecție
Se așteaptă informațiile inițiale ale transportatoruluiEfectuați verificări limitate, apoi măriți intervalul dacă nu există modificări.Nu tratați lipsa scanărilor ca dovadă a eșecului expedierii.
Se deplasează normalUtilizați intervalul de bază pentru serviciul sau ruta relevantă.Mențineți un interval maxim de reconciliere.
Se apropie de livrareLuați în considerare intervale mai scurte când actualizările prompte susțin o acțiune reală.Măsurați dacă solicitările suplimentare returnează informații noi.
Excepție sau inactivitate prelungităPrioritizați investigarea și utilizați un program de monitorizare limitat.Interogarea mai rapidă nu rezolvă excepția de bază.
Livrată sau finalizată în alt modEliminați expedierea din interogarea de rutină după verificările de închidere.Permiteți corecții și redeschideri legitime.

Asociați explicit stările furnizorului cu ciclul de viață intern. Nu presupuneți că o expediere returnată, o tentativă de livrare eșuată și o livrare finalizată ar trebui să oprească toate monitorizarea. Acestea pot necesita decizii operaționale diferite.

Stocați pentru fiecare expediere un marcaj temporal pentru următoarea verificare eligibilă și recalculați-l atunci când apar evenimente semnificative. Astfel, programarea devine auditabilă și evitați să vă bazați pe un temporizator care tratează fiecare înregistrare identic.

3. Utilizați webhook-uri pentru modificări atunci când furnizorul le acceptă

Interogarea întreabă dacă s-a schimbat ceva. Un webhook permite unui furnizor să vă notifice aplicația când este disponibilă o actualizare. Acolo unde sunt acceptate evenimentele necesare și comportamentul de livrare dorit, utilizați livrarea push ca metodă principală de ingestie, în loc să interogați repetat fiecare expediere activă.

Webhook-urile nu elimină întârzierile din amonte. Ele introduc și cerințe de gestionare a livrării. Verificați mecanismul de autentificare documentat al furnizorului, regulile de confirmare, comportamentul de reîncercare și identificatorii evenimentelor înainte de implementare.

  • Autentificați solicitările primite utilizând mecanismul documentat.
  • Stocați durabil sau introduceți într-o coadă notificarea validă înainte de a confirma primirea cu succes.
  • Procesați notificările idempotent, astfel încât o livrare repetată să nu declanșeze mesaje duplicate către clienți.
  • Gestionați evenimentele întârziate și cele primite în ordine greșită fără a suprascrie starea mai nouă cu informații mai vechi.
  • Monitorizați erorile de procesare și vechimea notificărilor aflate în coadă.

Nu presupuneți că livrarea webhook-urilor are loc exact o singură dată sau întotdeauna în ordine cronologică, cu excepția cazului în care furnizorul garantează explicit acest lucru. Păstrați istoricul evenimentelor expedierii separat de starea sa normalizată curentă, astfel încât informațiile întârziate să poată fi evaluate, nu aplicate orbește.

4. Adăugați reconciliere direcționată în locul unei a doua bucle complete de interogare

O integrare bazată pe webhook-uri are în continuare nevoie de o cale de recuperare. Endpoint-ul dvs. poate fi indisponibil, un worker poate eșua după primire sau o eroare internă de asociere poate împiedica actualizarea să ajungă la înregistrarea comenzii.

Reconcilierea verifică dacă starea stocată de dvs. corespunde stării furnizorului. Ea ar trebui să se concentreze asupra înregistrărilor care necesită verificare, nu să recreeze interogarea frecventă pentru întreaga populație de expedieri.

Candidații utili pentru reconciliere includ expedieri cu procesare eșuată a notificărilor, înregistrări care au depășit intervalul maxim de verificare și expedieri afectate de o întrerupere cunoscută. Un eveniment vechi al transportatorului nu constituie singur neapărat o dovadă a unei actualizări omise.

După o întrerupere, introduceți în coadă înregistrările afectate și procesați-le în limita unui buget controlat de solicitări. Eliminați duplicatele lucrărilor de recuperare suprapuse și anulați lucrările redundante atunci când o actualizare reușită a rezolvat deja discrepanța. Evitați lansarea simultană a unei solicitări pentru fiecare expediere activă.

Urmăriți separat marcajul temporal al ultimei verificări reușite și marcajul temporal al celui mai recent eveniment. În caz contrar, un colet fără o scanare recentă poate deveni eligibil în mod repetat pentru reconciliere, chiar dacă sistemul dvs. tocmai a confirmat că furnizorul nu are informații noi.

5. Memorați în cache datele de urmărire și partajați solicitările între consumatori

O pagină de urmărire, un tablou de bord pentru asistență, un worker de notificări și un sistem de comenzi pot solicita aceeași expediere. Oferiți-le o înregistrare comună la nivelul aplicației în loc să permiteți fiecărui consumator să interogheze independent furnizorul de urmărire.

Stocați local starea cunoscută cel mai recent a expedierii, împreună cu momentul recuperării și marcajele temporale relevante ale evenimentelor. Permiteți programatorului sau gestionarului de webhook-uri să actualizeze înregistrarea. Reîmprospătarea unei pagini de către client nu ar trebui să forțeze automat o altă solicitare în amonte.

Utilizați atât consolidarea solicitărilor, cât și memorarea în cache: dacă mai mulți consumatori solicită simultan aceeași înregistrare învechită, permiteți o singură operațiune de reîmprospătare, iar ceilalți să utilizeze sau să aștepte rezultatul acesteia. Definiți corect cheile cache-ului și verificările de acces, astfel încât datele să nu treacă între conturi.

Dacă un endpoint acceptă validatori HTTP precum ETag sau Last-Modified, solicitările condiționale pot reduce transferul corpului răspunsului. Totuși, o solicitare condițională rămâne o solicitare și poate fi în continuare contabilizată în limita furnizorului. Semantica memorării în cache HTTP este definită în RFC 9111; acceptarea acestora de către un anumit endpoint de urmărire trebuie verificată separat.

Faceți prospețimea ușor de înțeles în interfață. „Verificat ultima dată” ar trebui să descrie recuperarea, în timp ce „Cel mai recent eveniment al expedierii” ar trebui să descrie evenimentul transportatorului. Afișarea unui singur marcaj temporal ca și cum ar reprezenta ambele aspecte poate induce clienții în eroare.

6. Grupați căutările eligibile și distribuiți solicitările în timp

Când endpoint-ul de căutare relevant acceptă mai multe înregistrări de urmărire per solicitare, gruparea poate reduce numărul solicitărilor HTTP. Verificați dacă operațiunea de care aveți nevoie acceptă gruparea: înregistrarea în loturi nu implică automat recuperarea în loturi.

De asemenea, faceți distincție între eficiența transportului și facturare. O singură solicitare HTTP care conține mai multe înregistrări poate consuma în continuare mai multe unități de cotă sau căutări facturabile, în funcție de regulile furnizorului.

Un programator practic ar trebui să:

  1. Selecteze înregistrările al căror moment al următoarei verificări eligibile a sosit.
  2. Excludă înregistrările finalizate, suspendate sau deja introduse în coadă.
  3. Grupeze înregistrările eligibile în limitele documentate ale endpoint-ului și încărcăturii utile.
  4. Distribuie lucrările printr-un limitator comun de rată.
  5. Înregistreze rezultatul fiecărui element și să reîncerce doar elementele eșuate sau nerezolvate, acolo unde este cazul.

Distribuiți lucrările pe parcursul ferestrei de programare în loc să executați fiecare lucrare la începutul orei. Adăugați un decalaj aleatoriu limitat, numit adesea jitter, pentru a reduce rafalele sincronizate. Mențineți acest decalaj suficient de mic pentru a respecta obiectivul de prospețime al fiecărui flux de lucru.

Gruparea este mai puțin utilă atunci când așteptarea umplerii unui lot ar întârzia o actualizare urgentă. Permiteți lucrărilor sensibile la timp să continue fără un lot complet, menținându-le în același buget general de rată.

7. Adaptați-vă la limitele de rată, erori și verificări cu valoare redusă

Intervalul normal de actualizare nu ar trebui să fie și intervalul de reîncercare după erori. Un endpoint indisponibil necesită reîncercări controlate, nu un alt val complet de solicitări programate suprapus peste erori.

HTTP 429 înseamnă „Prea multe solicitări”, iar răspunsul poate include un câmp Retry-After, după cum este descris în RFC 6585. Semantica HTTP a câmpului este definită în RFC 9110. Urmați instrucțiunile aplicabile ale furnizorului și o valoare Retry-After validă atunci când este furnizată. În caz contrar, utilizați o reducere exponențială limitată cu jitter pentru erorile care permit reîncercarea.

Nu reîncercați la nesfârșit erorile de autentificare sau datele de urmărire invalide. Direcționați-le către corectare. Pentru operațiunile care modifică starea pe server, confirmați siguranța reîncercării înainte de a repeta automat o solicitare după o expirare ambiguă.

Adaptați separat interogarea normală. Dacă verificările reușite repetat nu returnează informații noi, luați în considerare prelungirea intervalului în limitele de prospețime ale expedierii. Atunci când un eveniment semnificativ mută coletul într-o etapă mai sensibilă la timp, reduceți din nou intervalul.

Aplicați limitarea ratei pentru toți workerii care partajează cota relevantă. Limitele independente ale workerilor pot părea fiecare conforme, în timp ce traficul lor combinat depășește limita la nivel de cont.

Validați împreună prospețimea și eficiența

Testați politica pe un grup controlat de expedieri înainte de a o aplica pe scară largă. Comparați fluxuri cu caracteristici similare privind transportatorul, ruta și ciclul de viață, astfel încât o modificare a mixului de expedieri să nu fie confundată cu o îmbunătățire a programării.

  • Randamentul actualizărilor utile: Proporția verificărilor reușite care adaugă informații semnificative.
  • Vechimea verificării: Timpul de la ultima verificare reușită a stării furnizorului.
  • Întârzierea ingestiei: Timpul dintre disponibilitatea la furnizor și primirea în aplicație, atunci când momentul disponibilității poate fi observat.
  • Presiunea solicitărilor: Volumul solicitărilor, răspunsurile privind limitele de rată, reîncercările și dimensiunea cozii.
  • Calitatea recuperării: Modificările omise recuperate prin reconciliere și timpul necesar pentru eliminarea erorilor.

Nu etichetați timpul de la evenimentul transportatorului până la ingestie drept întârziere pură a integrării. Acesta poate include întârzieri de publicare și colectare în amonte pe care aplicația dvs. nu le poate controla direct. O politică eficientă reduce recuperarea inutilă, menținând în același timp modificările importante operațional în limitele obiectivelor de prospețime definite.

Întrebări frecvente

Care este cel mai bun interval de interogare pentru urmărirea expedierilor?

Nu există un interval universal. Alegeți-l în funcție de obiectivul de prospețime al fluxului de lucru, comportamentul actualizărilor din amonte, limitele API și bugetul de solicitări. Începeți cu o bază documentată, măsurați valoarea verificărilor reușite și ajustați în funcție de starea ciclului de viață, în loc să faceți fiecare expediere să fie interogată mai rapid.

Reîmprospătarea unei pagini de urmărire forțează o nouă verificare a transportatorului?

Nu neapărat. Pagina poate citi cache-ul aplicației dvs. sau datele de urmărire stocate de furnizor. Reîmprospătarea browserului, o căutare API și o reîmprospătare a transportatorului din amonte sunt operațiuni distincte. Descrieți o reîmprospătare ca fiind live numai dacă acest lucru este susținut de comportamentul documentat.

Pot webhook-urile înlocui complet interogarea?

Ele pot înlocui o mare parte din interogarea de rutină atunci când furnizorul acceptă actualizările necesare. Păstrați un proces de reconciliere limitat pentru erori și stări incerte. Cât de multe verificări rămân necesare depinde de garanțiile de livrare, opțiunile de recuperare și consecințele unei actualizări omise.

Când ar trebui să se oprească solicitările de urmărire după livrare?

Eliminați expedierile livrate din interogarea activă de rutină după finalizarea verificărilor de închidere. Decideți dacă o perioadă limitată de verificare este justificată de fluxul dvs. de lucru și de comportamentul furnizorului. Păstrați posibilitatea de a procesa corecții fără a menține fiecare expediere finalizată într-un program nedeterminat.

Vor reduce întotdeauna mai puține solicitări HTTP costurile API?

Nu. Facturarea poate depinde de expedieri, înregistrări de urmărire, operațiuni sau o altă unitate contractuală, nu de numărul solicitărilor HTTP. Confirmați regulile de contorizare aplicabile înainte de a atribui economii financiare grupării, memorării în cache sau adoptării webhook-urilor.

Surse