Skip to main content
StartseiteBlogAnleitungenAnfrage zur Echtzeitverfolgung wegen Zeitüberschreitung abgebrochen? Zu befolgende Regeln für Wiederholung, Fallback und Status

Anfrage zur Echtzeitverfolgung wegen Zeitüberschreitung abgebrochen? Zu befolgende Regeln für Wiederholung, Fallback und Status

17TRACK

Wenn eine Echtzeit-Trackinganfrage wegen einer Zeitüberschreitung abbricht, behandeln Sie den neuesten Status der Sendung als unbekannt – nicht als verspätet, verloren oder unverändert. Wiederholen Sie die Anfrage nur innerhalb eines begrenzten Zeitbudgets und zeigen Sie anschließend ein klar gekennzeichnetes Update zum zuletzt bekannten Stand an oder bitten Sie den Benutzer, es später erneut zu versuchen. Trennen Sie während des gesamten Prozesses das Ergebnis der Anfrage, die Aktualität der Daten und den tatsächlichen Status des Pakets voneinander.

Zeitüberschreitung bei Echtzeit-Trackinganfrage, erneuter Versuch, Fallback und Status

Diese Unterscheidung ist sowohl für kundenorientierte Trackingseiten als auch für Systeme wichtig, die Trackingdaten verwenden, um Benachrichtigungen oder Supportprozesse auszulösen. Eine Zeitüberschreitung sagt Ihnen, dass eine Antwort nicht rechtzeitig eingetroffen ist. Sie sagt nicht aus, ob der Versanddienstleister ein neues Ereignis hat, ob ein vorgelagerter Dienst die Anfrage verarbeitet hat oder ob sich das Paket bewegt hat.

Zuerst feststellen, was die Zeitüberschreitung verursacht hat

Eine Trackinganfrage kann an mehreren Stellen fehlschlagen: Der Browser wartet möglicherweise nicht länger auf Ihre Anwendung, Ihre Anwendung wartet möglicherweise nicht länger auf eine Tracking-API oder diese API kann beim Kontakt mit einem anderen Dienst eine Zeitüberschreitung erleiden. Der Benutzer sieht möglicherweise in jedem Fall denselben allgemeinen Fehler, aber die geeignete nächste Aktion ist jeweils eine andere.

  • Clientseitige Zeitüberschreitung: Die Anwendung hat aufgehört zu warten. Die serverseitige Anfrage kann dennoch abgeschlossen worden sein. Prüfen Sie Ihre eigenen Anfrageprotokolle oder den Ergebnisspeicher, bevor Sie eine weitere Anfrage stellen, die doppelte Arbeit verursachen könnte.
  • Netzwerk- oder Verbindungsfehler: Ihr System hat keine nutzbare Antwort erhalten. Möglicherweise wissen Sie nicht, ob der entfernte Dienst die Anfrage verarbeitet hat.
  • HTTP 504: Ein Gateway oder Proxy hat keine rechtzeitige Antwort von einem vorgelagerten Server erhalten. Dies beschreibt den Anfragepfad, nicht die Sendung.
  • HTTP 408: Der Server hat innerhalb der vorgesehenen Wartezeit keine vollständige Anfragenachricht erhalten. Dies ist kein Trackingstatus des Versanddienstleisters.
  • HTTP 200 mit einem alten Ereignis: Die Anfrage war erfolgreich, aber die zurückgegebenen Trackinginformationen können weiterhin veraltet sein. Eine erfolgreiche HTTP-Antwort ist keine Garantie für Aktualität.

Erfassen Sie diese Ergebnisse als Diagnosedaten zur Anfrage. Übersetzen Sie keines davon in Sendungsbezeichnungen wie „unterwegs“, „Ausnahme“ oder „zugestellt“. Diese Bezeichnungen sollten aus Trackingereignissen oder einem dokumentierten Statusfeld stammen, nicht aus der Transportschicht.

Verwenden Sie begrenzte Wiederholungsversuche statt einer Endlosschleife

Bei einer schreibgeschützten Trackingabfrage ist ein Wiederholungsversuch nach einer Zeitüberschreitung oft sinnvoll. Er sollte dennoch begrenzt sein. Wiederholte Anfragen können die Belastung eines überlasteten Dienstes erhöhen, die Wartezeit des Benutzers verlängern und doppelte Arbeit erzeugen, wenn mehrere Anwendungsebenen unabhängig voneinander Wiederholungen durchführen.

  1. Setzen Sie eine Gesamtablaufzeit fest. Legen Sie fest, wie lange der benutzerseitige Vorgang einschließlich des ersten Versuchs und aller Wiederholungen dauern darf. Geben Sie nicht jedem Versuch eine neue vollständige Ablaufzeit, die die Wartezeit des Aufrufers überschreitet.
  2. Prüfen Sie, ob der Vorgang sicher wiederholt werden kann. Eine Abfrage unterscheidet sich normalerweise von einer Anfrage, die eine Sendung registriert, Einstellungen ändert oder eine Ressource erstellt. Wiederholen Sie eine zustandsverändernde Anfrage nicht automatisch, es sei denn, der Vertrag des Anbieters oder Ihre Idempotenzkontrollen machen dies sicher.
  3. Wiederholen Sie vorübergehende Fehler sparsam. Verwenden Sie ein kleines, ausdrücklich festgelegtes Wiederholungsbudget und eine Verzögerung mit Jitter, statt von vielen Clients gleichzeitig sofortige Wiederholungen zu senden.
  4. Beachten Sie geltende Anweisungen des Servers. Wenn eine Antwort einen gültigen Retry-After-Header enthält, planen Sie keinen früheren Wiederholungsversuch. Beachten Sie außerdem strengere Anwendungs- oder anbieterspezifische Begrenzungen.
  5. Beenden Sie den Vorgang, wenn Frist oder Budget erschöpft sind. Wechseln Sie zu einer Fallback-Antwort und planen Sie eine spätere Abgleichung separat, falls Ihr Prozess dies erfordert.

Ein praktisches Design könnte einen benutzerseitigen Wiederholungsversuch erlauben, wenn noch genügend Zeit verbleibt, und weitere Versuche in eine Hintergrundaktualisierung verlagern. Dies ist ein Beispiel für eine Richtlinie, keine allgemeingültige API-Regel. Wählen Sie die Grenzen anhand Ihrer Serviceziele, der beobachteten Latenz und der Dokumentation des Anbieters. Zählen Sie außerdem Wiederholungen von HTTP-Bibliotheken, Gateways und Job-Workern mit; andernfalls kann eine scheinbar moderate Anwendungsrichtlinie viele Aufrufe an vorgelagerte Systeme erzeugen.

Behandeln Sie HTTP 429 als Signal für eine Ratenbegrenzung und nicht als Grund für einen sofortigen Wiederholungsversuch. HTTP 503 kann auf eine vorübergehende Unfähigkeit hinweisen, die Anfrage zu verarbeiten, und ein Server kann Retry-After bereitstellen. Ein 504 kann vorübergehend sein, garantiert jedoch nicht, dass der nächste Versuch funktioniert. Authentifizierungsfehler erfordern im Allgemeinen die Prüfung von Zugangsdaten oder Berechtigungen, während fehlerhafte Anfragen eine Korrektur der Eingaben erfordern. Eine Tracking-ID, die ein Ergebnis „nicht gefunden“ liefert, erfordert mehr Sorgfalt: Abhängig vom dokumentierten Verhalten des Anbieters und der Phase der Sendung kann es zu früh sein, einen Datensatz zu finden, oder die ID kann falsch sein. Wandeln Sie ein solches einzelnes Ergebnis nicht in die definitive Aussage um, dass das Paket nicht existiert.

Wählen Sie einen Fallback, der das vorhandene Wissen bewahrt

Der sicherste Fallback ist normalerweise das zuletzt verifizierte Trackingergebnis, ergänzt um die eigene Ereigniszeit und eine ehrliche Kennzeichnung der Aktualität. Halten Sie dieses Ergebnis getrennt vom aktuellen Fehler der Anfrage. Eine Seite könnte beispielsweise anzeigen: „Letztes verfügbares Update: Anlage verlassen. Zuletzt geprüft: [Zeit]. Ein neueres Update ist vorübergehend nicht verfügbar.“ Fügen Sie „Zuletzt geprüft“ nur hinzu, wenn Ihr System dies tatsächlich erfasst; es ist kein Ersatz für die Ereigniszeit des Versanddienstleisters.

Verwenden Sie die genaueste Zeitangabe, die Sie belegen können. Die Ereigniszeit des Versanddienstleisters beschreibt, wann ein Ereignis angeblich stattgefunden hat. Die Zeit, zu der Ihr System dieses Ereignis empfangen hat, beschreibt die Übernahme. Die Zeit, zu der ein Benutzer die Seite geöffnet hat, beschreibt keines von beidem. Wenn die Quelle keine verlässliche Ereigniszeit oder Zeitzone bereitstellt, erfinden Sie keine. Wenn für das zwischengespeicherte Ergebnis ebenfalls keine Abrufzeit erfasst wurde, bezeichnen Sie es als „letztes verfügbares Update“, statt zu behaupten, es sei kürzlich aktualisiert worden.

Ein Fallback sollte drei Grenzen beachten:

  • Zeigen Sie zwischengespeicherte Daten als zwischengespeicherte Daten an. Stellen Sie ein älteres Ereignis nicht als Ergebnis der Anfrage dar, bei der eine Zeitüberschreitung aufgetreten ist.
  • Leiten Sie keinen Fortschritt aus der verstrichenen Zeit ab. Ein Paket ist nicht allein deshalb „in Zustellung“, weil es sich mehrere Tage im Transport befindet.
  • Verbergen Sie keine wesentliche Unsicherheit. Wenn kein vorheriges Ergebnis vorliegt, sagen Sie, dass das Tracking vorübergehend nicht verfügbar ist, anstatt einen erfundenen Standardstatus anzuzeigen.

Weitere Fallback-Wege können ein zuvor synchronisierter Tracking-Speicher, eine autorisierte Abfrage beim Versanddienstleister oder eine spätere Hintergrundaktualisierung sein. Verwenden Sie sie nur, wenn sie zur Sendung, Ihren Berechtigungen und den Bedingungen der Datenquelle passen. Eine zweite Quelle kann andere Ereignisnamen oder Meldeverzögerungen aufweisen. Bewahren Sie daher die Herkunft und führen Sie widersprüchliche Datensätze nicht ohne eine entsprechende Regel zusammen. Wenn ein Kunde auf Grundlage des Ergebnisses handeln kann, bieten Sie eine Möglichkeit zum erneuten Versuch oder zur Kontaktaufnahme mit dem Support an, statt dauerhaft einen Ladeindikator anzuzeigen.

Anfragestatus, Datenaktualität und Sendungsstatus getrennt halten

Dies sind drei verschiedene Felder, auch wenn eine Benutzeroberfläche sie gemeinsam darstellt. Der Anfragestatus gibt an, ob die Abfrage erfolgreich war, eine Zeitüberschreitung auftrat oder ein Fehler empfangen wurde. Die Datenaktualität gibt an, wann die zurückgegebenen oder gespeicherten Informationen beobachtet wurden. Der Sendungsstatus gibt an, was die Trackingquelle über das Paket meldet. Ihre Trennung verhindert, dass ein vorübergehender API-Fehler ein gültiges Zustellereignis überschreibt oder ein veraltetes Ereignis „unterwegs“ in eine aktuelle Aussage verwandelt.

Beispielsweise kann ein System ein verifiziertes Ereignis „Zugestellt“ aus einer früheren Abfrage speichern, während die aktuelle Aktualisierung wegen einer Zeitüberschreitung fehlschlägt. Das Zustellereignis verschwindet nicht. Der korrekte kombinierte Zustand lautet, dass der zuletzt verfügbare Sendungsstatus „zugestellt“ ist und die letzte Aktualisierung fehlgeschlagen ist. Wenn das letzte Ereignis dagegen „Unterwegs“ lautet, bestätigt eine Zeitüberschreitung nicht, dass sich das Paket in diesem Moment weiterhin unterwegs befindet; sie bestätigt nur, dass keine neuere Antwort erhalten wurde.

Wenden Sie eine definierte Regel an, wenn Ereignisse in falscher Reihenfolge eintreffen. Vergleichen Sie, sofern verfügbar, Ereignis-IDs, Zeitstempel, Quelle und die dokumentierte Statussemantik des Anbieters. Gehen Sie nicht davon aus, dass die Reihenfolge, in der Ihr System Aktualisierungen empfangen hat, der Reihenfolge entspricht, in der die Sendungsereignisse stattgefunden haben. Ebenso sollte ein verspätet eintreffendes älteres Ereignis nicht automatisch einen neueren verifizierten Status ersetzen. Korrekturen und Ausnahmen können jedoch legitim sein. Vermeiden Sie daher eine pauschale Regel, die Statusänderungen nach der Zustellung als unmöglich behandelt. Bewahren Sie die zugrunde liegenden Ereignisse auf und untersuchen Sie Widersprüche, statt die Historie stillschweigend umzuschreiben.

Wenn ein Anbieter HTTP 202 zurückgibt, interpretieren Sie dies gemäß dem Vertrag dieses Endpunkts: Die Annahme einer Anfrage bedeutet für sich genommen nicht, dass die Trackingabfrage abgeschlossen ist. Ebenso bestätigt HTTP 200, dass eine HTTP-Anfrage gemäß der Semantik dieses Endpunkts erfolgreich war; es beweist nicht, dass jedes Trackingfeld vorhanden oder aktuell ist. Ordnen Sie anbieterspezifische Antwortfelder erst zu, nachdem Sie die Dokumentation des Anbieters geprüft haben.

Den Fehler für die Betreiber sichtbar machen, ohne Kunden zu beunruhigen

Ein nützlicher Betriebsdatensatz enthält die Anfrage-ID, den Endpunkt oder Vorgang, die Anzahl der Versuche, die verstrichene Zeit, die Ebene der Zeitüberschreitung, den HTTP-Status, sofern einer empfangen wurde, und die Information, ob die Antwort aus einer Live-Abfrage oder einem Fallback stammt. Erfassen Sie für Trackingdaten die Quelle sowie relevante Ereignis- oder Abrufzeitstempel. Behandeln Sie Trackingnummern und Kundendaten gemäß den Zugriffs- und Aufbewahrungsregeln Ihrer Organisation; der diagnostische Nutzen ist kein Grund, vollständige IDs in uneingeschränkten Protokollen offenzulegen.

Achten Sie auf Muster, statt sich auf eine einzelne Zeitüberschreitung zu verlassen. Eine steigende Zeitüberschreitungsrate auf einer bestimmten Versanddienstleisterroute, wiederholte 429-Antworten oder eine wachsende Lücke zwischen Ereigniszeit des Versanddienstleisters und Abrufzeit können auf unterschiedliche Probleme hinweisen. Das erste kann eine Untersuchung beim Anbieter erfordern, das zweite eine Ratensteuerung und das dritte eine Prüfung der Synchronisierung oder Ereignisübermittlung. Wenn eine Anwendung Tracking über einen Anbieter wie die 17TRACK Tracking API anbietet, verwenden Sie dessen Dokumentation, um endpunktspezifische Antwortfelder, Anfragegrenzen und Fehlerbehandlung vor der Umsetzung dieser allgemeinen Regeln zu überprüfen.

Für die kundenorientierte Nachricht sollten Sie präzise und zurückhaltend formulieren: „Wir konnten das Tracking gerade nicht aktualisieren. Hier ist das letzte verfügbare Update.“ Geben Sie einen nächsten Schritt an, wenn dies hilfreich ist, etwa später erneut zu prüfen oder den Support zu kontaktieren, wenn die Sendung über das vom Verkäufer oder Versanddienstleister angegebene erwartete Lieferfenster hinausgeht. Vermeiden Sie es, eine Aktualisierungszeit zu versprechen, die Ihr System nicht garantieren kann.

Checkliste für die Veröffentlichung eines ausfallsicheren Trackingprozesses

  • Bestätigen Sie, welche Ebene jede Zeitüberschreitung festlegt und welche Ebene für Wiederholungen zuständig ist.
  • Legen Sie eine Gesamtablaufzeit für die Anfrage und ein separates, begrenztes Wiederholungsbudget fest.
  • Stellen Sie sicher, dass automatisch wiederholte Vorgänge sicher wiederholt werden können.
  • Beachten Sie Ratenbegrenzungen und gültige Retry-After-Anweisungen.
  • Speichern Sie das Ergebnis der Anfrage getrennt vom Sendungsstatus und der Ereignishistorie.
  • Kennzeichnen Sie Fallbackdaten und bewahren Sie, sofern verfügbar, deren Quelle und Zeitstempel auf.
  • Testen Sie Szenarien ohne Cache, mit veraltetem Cache, 429, 503, 504 und verspäteten Antworten.
  • Prüfen Sie, dass eine Zeitüberschreitung keine falsche Zustellbenachrichtigung auslösen oder ein verifiziertes Ereignis löschen kann.

Die maßgebliche Regel ist einfach: Wiederholen Sie eine Anfrage nur, wenn dies sicher und nützlich ist; greifen Sie nur auf Informationen zurück, deren Herkunft Sie angeben können; und treffen Sie niemals anhand einer HTTP-Zeitüberschreitung eine Aussage zum Sendungsstatus.

FAQ

Soll ich eine Trackinganfrage nach einer Zeitüberschreitung sofort wiederholen?

Nicht automatisch. Prüfen Sie, ob der Vorgang sicher wiederholt werden kann, ob die Gesamtablaufzeit noch genügend Zeit für einen weiteren Versuch lässt und ob keine Ratenbegrenzung zum Warten auffordert. Ein kurzer, begrenzter Wiederholungsversuch mit Jitter kann bei einer schreibgeschützten Abfrage angemessen sein; wiederholte sofortige Versuche sind keine gute Standardeinstellung.

Bedeutet HTTP 504, dass das Trackingsystem des Versanddienstleisters ausgefallen ist?

Nein. Es bedeutet, dass ein Gateway oder Proxy keine rechtzeitige Antwort vom vorgelagerten Dienst erhalten hat. Das Problem kann an jeder Stelle dieses Anfragepfads liegen. Daraus lässt sich weder die allgemeine Verfügbarkeit des Versanddienstleisters noch der Zustand des Pakets ableiten.

Kann ich den zuletzt bekannten Status nach einer Zeitüberschreitung anzeigen?

Ja, wenn Sie ihn als zuletzt verfügbare Information und nicht als erfolgreiche Live-Aktualisierung kennzeichnen. Zeigen Sie die Ereigniszeit und die Abrufzeit an, sofern sie bekannt sind, und machen Sie deutlich, dass ein neueres Update nicht bestätigt werden konnte.

Soll eine Zeitüberschreitung eine Sendung von „unterwegs“ auf „Ausnahme“ ändern?

Nein. Eine Zeitüberschreitung ist ein Fehler der Anfrage, kein Sendungsereignis. Ändern Sie den Sendungsstatus nur, wenn eine vertrauenswürdige Trackingquelle ein Ereignis oder einen Status liefert, der diese Änderung unterstützt.

Was ist, wenn die Anfrage mit Zeitüberschreitung einen Trackingdatensatz erstellt oder registriert hat?

Gehen Sie nicht davon aus, dass sie fehlgeschlagen ist. Das entfernte System kann sie verarbeitet haben, bevor die Antwort verloren ging. Prüfen Sie, ob bereits ein Ergebnis vorhanden ist, und verwenden Sie einen dokumentierten Idempotenzmechanismus oder ein vom Anbieter genehmigtes Wiederherstellungsverfahren, bevor Sie die Anfrage erneut senden.

Quellen