Fikk forespørselen om sporing i sanntid tidsavbrudd? Regler for nytt forsøk, reserveløsning og status som skal følges
Når en forespørsel om sporing i sanntid får tidsavbrudd, skal forsendelsens nyeste status behandles som ukjent – ikke som forsinket, tapt eller uendret. Prøv på nytt bare innenfor en begrenset tidsramme, og vis deretter en tydelig merket siste kjente oppdatering eller be brukeren prøve igjen senere. Hold forespørselens resultat, dataenes aktualitet og pakkens faktiske status adskilt gjennom hele prosessen.
Dette skillet er viktig både for sporingssider rettet mot kunder og for systemer som bruker sporingsdata til å utløse varsler eller støtteprosesser. Et tidsavbrudd forteller deg at et svar ikke kom frem i tide. Det forteller deg ikke om transportøren har en ny hendelse, om en oppstrøms tjeneste behandlet forespørselen, eller om pakken har beveget seg.
Identifiser først hva som fikk tidsavbrudd
En sporingsforespørsel kan mislykkes på flere punkter: Nettleseren kan slutte å vente på applikasjonen din, applikasjonen din kan slutte å vente på et sporings-API, eller API-et kan få tidsavbrudd mens det kontakter en annen tjeneste. Brukeren kan se den samme generelle feilen i hvert tilfelle, men riktig neste handling varierer.
- Tidsavbrudd på klientsiden: Appen sluttet å vente. Forespørselen på serversiden kan likevel ha blitt fullført. Sjekk dine egne forespørselslogger eller resultatlageret før du sender en ny forespørsel som kan duplisere arbeidet.
- Nettverks- eller tilkoblingsfeil: Systemet ditt mottok ikke et brukbart svar. Du vet kanskje ikke om den eksterne tjenesten behandlet forespørselen.
- HTTP 504: En gateway eller proxy mottok ikke et tidsnok svar fra en oppstrømsserver. Dette beskriver forespørselsbanen, ikke forsendelsen.
- HTTP 408: Serveren mottok ikke en fullstendig forespørselsmelding innen tiden den var forberedt på å vente. Dette er ikke en sporingsstatus fra transportøren.
- HTTP 200 med en gammel hendelse: Forespørselen lyktes, men den returnerte sporingsinformasjonen kan fortsatt være utdatert. Et vellykket HTTP-svar er ingen garanti for aktualitet.
Registrer disse resultatene som forespørselsdiagnostikk. Ikke oversett noen av dem til forsendelsesetiketter som «under transport», «avvik» eller «levert». Disse etikettene skal komme fra sporingshendelser eller et dokumentert statusfelt, ikke fra transportlaget.
Bruk et begrenset nytt forsøk, ikke en løkke uten ende
For et skrivebeskyttet oppslag av sporingsinformasjon er et nytt forsøk etter et tidsavbrudd ofte rimelig. Det bør likevel være begrenset. Gjentatte forespørsler kan øke belastningen på en tjeneste som har problemer, forlenge brukerens ventetid og skape dobbeltarbeid når flere applikasjonslag prøver på nytt uavhengig av hverandre.
- Angi en total tidsfrist. Bestem hvor lenge den brukerrettede operasjonen kan ta, inkludert første forsøk og eventuelle nye forsøk. Ikke gi hvert forsøk en ny, full tidsfrist som overskrider tiden innringeren kan vente.
- Kontroller om operasjonen er trygg å gjenta. Et oppslag skiller seg vanligvis fra en forespørsel som registrerer en forsendelse, endrer innstillinger eller oppretter en ressurs. Ikke gjenta automatisk en forespørsel som endrer tilstand, med mindre leverandørens avtale eller dine idempotenskontroller gjør dette trygt.
- Prøv sparsomt på nytt ved en midlertidig feil. Bruk et lite, uttrykkelig budsjett for nye forsøk og en forsinkelse med jitter i stedet for å sende samtidige, umiddelbare nye forsøk fra mange klienter.
- Følg gjeldende instruksjoner fra serveren. Hvis et svar inneholder en gyldig
Retry-After-header, skal du ikke planlegge et tidligere nytt forsøk. Respekter også eventuelle strengere grenser i applikasjonen eller hos leverandøren. - Stopp når tidsfristen eller budsjettet er brukt opp. Bytt til et reservesvar, og planlegg separat senere avstemming hvis arbeidsflyten trenger det.
Et praktisk design kan tillate ett brukerrettet nytt forsøk hvis det er nok tid igjen, mens ytterligere forsøk flyttes til en bakgrunnsoppdatering. Dette er et eksempel på en policy, ikke en universell API-regel. Velg grenser ut fra tjenestenivåmålene dine, observert svartid og leverandørens dokumentasjon. Tell også med nye forsøk fra HTTP-biblioteker, gateways og jobbprosesser; ellers kan en tilsynelatende moderat applikasjonspolicy føre til mange oppstrømskall.
For HTTP 429 skal svaret behandles som et signal om hastighetsbegrensning, ikke som en grunn til å prøve på nytt umiddelbart. HTTP 503 kan indikere en midlertidig manglende evne til å håndtere forespørselen, og en server kan oppgi Retry-After. En 504 kan være midlertidig, men garanterer ikke at neste forsøk vil fungere. Autentiseringsfeil krever vanligvis kontroll av legitimasjon eller tillatelser, mens ugyldige forespørsler krever korrigering av inndata. Et sporingsnummer som gir resultatet «ikke funnet», krever mer omtanke: Avhengig av leverandørens dokumenterte virkemåte og forsendelsens fase kan det være for tidlig å finne en registrering, eller identifikatoren kan være feil. Ikke gjør ett slikt resultat om til en definitiv påstand om at pakken ikke finnes.
Velg en reservehåndtering som bevarer det du vet
Den tryggeste reservehåndteringen er vanligvis det siste bekreftede sporingsresultatet, sammen med dets egen hendelsestid og en ærlig merking av aktualiteten. Hold dette resultatet adskilt fra den nåværende forespørselsfeilen. En side kan for eksempel si: «Siste tilgjengelige oppdatering: Forlot terminal. Sist kontrollert: [tidspunkt]. En nyere oppdatering er midlertidig utilgjengelig.» Ta bare med «Sist kontrollert» hvis systemet faktisk registrerer dette; det erstatter ikke transportørens hendelsestid.
Bruk det mest presise tidspunktet du kan dokumentere. En hendelsestid fra transportøren beskriver når en hendelse angivelig fant sted. Tidspunktet da systemet ditt mottok hendelsen, beskriver innhentingen. Tidspunktet da en bruker åpnet siden, beskriver ingen av delene. Hvis kilden ikke oppgir et pålitelig hendelsestidspunkt eller en tidssone, bør du unngå å finne på et. Hvis det bufrede resultatet heller ikke har et registrert tidspunkt for innhenting, bør du kalle det en «siste tilgjengelige oppdatering» i stedet for å hevde at det nylig ble oppdatert.
En reservehåndtering bør følge tre grenser:
- Vis bufrede data som bufrede data. Ikke presenter en eldre hendelse som resultatet av forespørselen som fikk tidsavbrudd.
- Ikke utled fremdrift fra medgått tid. En pakke er ikke «ute for levering» bare fordi den har vært under transport i flere dager.
- Ikke skjul vesentlig usikkerhet. Hvis det ikke finnes et tidligere resultat, skal du si at sporing midlertidig er utilgjengelig i stedet for å vise en oppdiktet standardstatus.
Andre reserveveier kan omfatte et tidligere synkronisert sporingslager, et autorisert oppslag hos transportøren eller en senere bakgrunnsoppdatering. Bruk dem bare hvis de passer til forsendelsen, tillatelsene dine og datakildens vilkår. En annen kilde kan ha andre hendelsesnavn eller rapporteringsforsinkelser, så bevar opphavsinformasjonen og unngå å slå sammen motstridende registreringer uten en regel for hvordan dette skal gjøres. Hvis en kunde kan handle ut fra resultatet, bør du tilby en måte å prøve på nytt eller kontakte kundestøtte på i stedet for å la en spinner stå på ubestemt tid.
Hold forespørselsstatus, dataenes aktualitet og forsendelsesstatus adskilt
Dette er tre forskjellige felt, selv om et brukergrensesnitt viser dem sammen. Forespørselsstatus sier om oppslaget lyktes, fikk tidsavbrudd eller mottok en feil. Dataenes aktualitet sier når den returnerte eller lagrede informasjonen ble observert. Forsendelsesstatus sier hva sporingskilden rapporterer om pakken. Ved å skille dem hindrer du at en midlertidig API-feil overskriver en gyldig leveringshendelse eller gjør en utdatert hendelse om «under transport» til en aktuell påstand.
Et system kan for eksempel ha en bekreftet «Levert»-hendelse fra et tidligere oppslag mens den nåværende oppdateringen får tidsavbrudd. Leveringshendelsen forsvinner ikke. Den riktige kombinerte tilstanden er at den siste tilgjengelige forsendelsesstatusen er levert, og at den nyeste oppdateringen mislyktes. Hvis den siste hendelsen derimot er «Under transport», bekrefter et tidsavbrudd ikke at pakken fortsatt er under transport akkurat nå; det bekrefter bare at det ikke ble innhentet et nyere svar.
Bruk en definert regel når hendelser kommer i feil rekkefølge. Sammenlign hendelsesidentifikatorer, tidsstempler, kilde og leverandørens dokumenterte statusspråk der dette er tilgjengelig. Ikke anta at rekkefølgen systemet ditt mottok oppdateringene i, er rekkefølgen forsendelseshendelsene fant sted i. En eldre hendelse som kommer sent, bør heller ikke automatisk erstatte en nyere, bekreftet status. Korrigeringer og avvik kan likevel være legitime, så unngå en generell regel som behandler statusendringer etter levering som umulige. Bevar de underliggende hendelsene og undersøk motsetninger i stedet for å omskrive historikken i stillhet.
Hvis en leverandør returnerer HTTP 202, skal svaret tolkes i henhold til endepunktets avtale: At en forespørsel er akseptert, betyr ikke i seg selv at et sporingsoppslag er fullført. På samme måte fastslår HTTP 200 at en HTTP-forespørsel lyktes i henhold til dette endepunktets semantikk; det beviser ikke at alle sporingsfelt finnes eller er oppdaterte. Tilordne leverandørspesifikke svarfelt først etter at du har kontrollert leverandørens dokumentasjon.
Gjør feilen synlig for operatører uten å skremme kundene
En nyttig driftsregistrering inneholder forespørsels-ID, endepunkt eller operasjon, antall forsøk, medgått tid, laget der tidsavbruddet oppstod, HTTP-status hvis en ble mottatt, og om svaret kom fra et aktivt oppslag eller en reservehåndtering. For sporingsdata bør du registrere kilden og relevante tidsstempler for hendelser eller innhenting. Behandle sporingsnumre og kundeopplysninger i samsvar med organisasjonens regler for tilgang og oppbevaring; diagnostisk nytte er ikke en grunn til å eksponere fullstendige identifikatorer i logger uten begrenset tilgang.
Se etter mønstre i stedet for å basere deg på ett enkelt tidsavbrudd. En økende andel tidsavbrudd på én transportørrute, gjentatte 429-svar eller et økende gap mellom transportørens hendelsestid og innhentingstid kan peke på ulike problemer. Det første kan kreve undersøkelse hos leverandøren, det andre kan kreve hastighetskontroll, og det tredje kan kreve kontroll av synkronisering eller hendelseslevering. Hvis en applikasjon tilbyr sporing gjennom en leverandør som 17TRACK Tracking API, bør du bruke leverandørens dokumentasjon til å kontrollere endepunktspesifikke svarfelt, forespørselsgrenser og feilhåndtering før du implementerer disse generelle reglene.
For kundemeldingen bør du være presis og nøktern: «Vi kunne ikke oppdatere sporingen akkurat nå. Her er den siste tilgjengelige oppdateringen.» Gi et neste trinn når det er nyttig, for eksempel å prøve igjen senere eller kontakte kundestøtte hvis forsendelsen er forbi et forventet leveringstidspunkt oppgitt av selgeren eller transportøren. Unngå å love et oppdateringstidspunkt som systemet ditt ikke kan garantere.
Sjekkliste for lansering av en tidsavbruddssikker sporingsflyt
- Bekreft hvilket lag som innfører hvert tidsavbrudd, og hvilket lag som håndterer nye forsøk.
- Angi en total forespørselsfrist og et separat, begrenset budsjett for nye forsøk.
- Kontroller at operasjoner som prøves på nytt automatisk, er trygge å gjenta.
- Respekter hastighetsbegrensninger og gyldige
Retry-After-instruksjoner. - Lagre forespørselsresultatet separat fra forsendelsesstatus og hendelseshistorikk.
- Merk reservedata og behold kilde og tidsstempler når de er tilgjengelige.
- Test scenarier uten hurtigbuffer, med utdatert hurtigbuffer, 429, 503, 504 og sene svar.
- Kontroller at et tidsavbrudd ikke kan utløse et feilaktig leveringsvarsel eller slette en bekreftet hendelse.
Hovedregelen er enkel: Prøv en forespørsel på nytt bare når det er trygt og nyttig; bruk reservehåndtering bare for informasjon du kan identifisere; og kom aldri med en påstand om forsendelsesstatus basert på et HTTP-tidsavbrudd.
Vanlige spørsmål
Bør jeg prøve en forespørsel om sporing som fikk tidsavbrudd på nytt umiddelbart?
Ikke automatisk. Kontroller at operasjonen er trygg å gjenta, at den samlede tidsfristen gir tid til et nytt forsøk, og at ingen instruksjon om hastighetsbegrensning sier at du må vente. Et kort, begrenset nytt forsøk med jitter kan være passende for et skrivebeskyttet oppslag; gjentatte umiddelbare nye forsøk er et dårlig standardvalg.
Betyr HTTP 504 at transportørens sporingssystem er nede?
Nei. Det betyr at en gateway eller proxy ikke mottok et tidsnok svar fra oppstrøms. Problemet kan befinne seg hvor som helst langs denne forespørselsbanen. Det fastslår ikke transportørens generelle tilgjengelighet eller pakkens tilstand.
Kan jeg vise den sist kjente statusen etter et tidsavbrudd?
Ja, hvis du merker den som den siste tilgjengelige informasjonen i stedet for en vellykket aktiv oppdatering. Vis hendelsestid og innhentingstid når de er kjent, og gjør det tydelig at en nyere oppdatering ikke kunne bekreftes.
Bør et tidsavbrudd endre en forsendelse fra «under transport» til «avvik»?
Nei. Et tidsavbrudd er en forespørselsfeil, ikke en forsendelseshendelse. Endre forsendelsesstatusen bare når en pålitelig sporingskilde leverer en hendelse eller status som støtter endringen.
Hva om forespørselen som fikk tidsavbrudd, opprettet eller registrerte en sporingspost?
Ikke anta at den mislyktes. Det eksterne systemet kan ha behandlet den før svaret gikk tapt. Se etter et eksisterende resultat, og bruk en dokumentert idempotensmekanisme eller en gjenopprettingsprosedyre godkjent av leverandøren før du sender den inn på nytt.
Kilder
- RFC 9110, HTTP Semantics — definisjoner av HTTP-statuser,
Retry-Afterog hensyn ved nye forespørsler. - RFC 6585, Additional HTTP Status Codes — definisjon av HTTP 429 og bruken sammen med
Retry-After. - Amazon Builders’ Library, «Timeouts, retries, and backoff with jitter» — teknisk veiledning om forsterkning av nye forsøk, tilbakekobling og jitter.
- 17TRACK Tracking API documentation — referanse for kontroll av leverandørspesifikk API-virkemåte før implementering.


