7 Möglichkeiten zur Konfiguration der Aktualisierungsfrequenz der Sendungsverfolgung: aktuellere Daten, weniger API-Anfragen
Konfigurieren Sie die Aktualisierungshäufigkeit der Sendungsverfolgung, indem Sie ein Aktualitätsziel festlegen, die Abfrageintervalle je nach Sendungsstatus variieren, Webhooks verwenden, sofern unterstützt, verpasste Aktualisierungen abgleichen, gemeinsame Ergebnisse zwischenspeichern, geplante Aufgaben bündeln und bei Fehlern oder Ratenbegrenzungen die Abstände vergrößern. Für Entwickler- und Betriebsteams besteht das Ziel nicht im kürzestmöglichen Intervall, sondern darin, nützliche Änderungen an Sendungen in Ihre Systeme zu übernehmen, ohne wiederholt unveränderte Daten anzufordern.
Diese Steuerungen gehören normalerweise in die Anwendung, die Ihren Tracking-Anbieter mit einem Auftragsverwaltungssystem, einer Supportplattform oder einer kundenorientierten Tracking-Seite verbindet. Einige Anbieter bieten auch eigene Aktualisierungssteuerungen an. Halten Sie diese beiden Ebenen getrennt: Eine Änderung des Anfragezeitplans Ihrer Anwendung ändert nicht zwangsläufig, wie häufig ein Anbieter den Transportdienstleister abfragt.
Ermitteln Sie zunächst, welche Aktualisierungshäufigkeit Sie steuern können
Eine Aktualisierung der Sendung durchläuft mehrere Phasen, bevor ein Kunde sie sieht. Ein Transportdienstleister erfasst ein Ereignis, ein Tracking-Dienst ruft es ab, Ihre Anwendung empfängt oder ruft es ab, und Ihre Benutzeroberfläche zeigt es an. Verzögerungen in jeder Phase können dazu führen, dass die Sendungsverfolgung veraltet erscheint.
- Verfügbarkeit des Ereignisses beim Transportdienstleister: Zeitpunkt, zu dem der Transportdienstleister einen Scan oder eine Statusänderung erfasst und veröffentlicht.
- Aktualisierungshäufigkeit des Anbieters: Zeitpunkt, zu dem ein Tracking-Dienst Informationen des Transportdienstleisters abfragt oder empfängt.
- Abrufhäufigkeit der Anwendung: Zeitpunkt, zu dem Ihr System Informationen anfordert oder eingehende Benachrichtigungen verarbeitet.
- Aktualisierungshäufigkeit der Anzeige: Zeitpunkt, zu dem Ihre Website, App oder Ihr Support-Tool seine lokale Ansicht aktualisiert.
Häufigeres Abfragen eines Anbieters kann die dritte Verzögerung reduzieren. Es garantiert jedoch keinen neueren Scan des Transportdienstleisters und erzwingt keine vorgelagerte Aktualisierung, sofern ein dokumentierter Endpunkt diese Aktion nicht ausdrücklich ausführt. Klären Sie vor einer Änderung des Zeitplans, ob eine API-Anfrage gespeicherte Tracking-Daten liest, eine Aktualisierung einleitet oder etwas anderes bewirkt.
Für eine 17TRACK-Integration beginnen Sie mit der Übersicht der Tracking API und der offiziellen API-Dokumentation. Bestätigen Sie das Verhalten der von Ihnen geplanten Vorgänge, einschließlich der Zustellung von Aktualisierungen, Anfragegrenzen und etwaiger Aktualisierungssteuerungen. Die folgenden Zeitplanmuster sind Empfehlungen für die Anwendung und keine Aussage darüber, dass jedes Intervall eine konfigurierbare 17TRACK-Einstellung ist.
1. Legen Sie vor der Wahl eines Intervalls ein Aktualitätsziel fest
Definieren Sie, wie schnell jeder Geschäftsprozess von einem neu verfügbaren Ereignis erfahren muss. Eine Warteschlange für Zustellungsprobleme kann ein kürzeres Ziel rechtfertigen als ein historisches Sendungs-Dashboard. Für beide dasselbe Abfrageintervall zu verwenden, verschwendet Anfragen oder lässt den dringenderen Prozess unzureichend versorgt.
Trennen Sie zwei Messwerte: die Zeit seit Ihrem letzten erfolgreichen Abruf und das Alter des neuesten Sendungsereignisses. Eine erfolgreiche Anfrage kann ein altes Ereignis zurückgeben, weil sich nichts geändert hat. Das unterscheidet sich von einer fehlgeschlagenen Integration, die kürzlich keine Daten abgerufen hat.
Verwenden Sie eine kleine Konfigurationsrichtlinie, statt Intervalle im gesamten Code zu hinterlegen:
- Aktualitätsziel: Die akzeptable Verzögerung zwischen der Verfügbarkeit beim Anbieter und der Aufnahme durch die Anwendung.
- Normales Abfrageintervall: Das Standardintervall für geeignete Sendungen.
- Maximale Abgleichslücke: Wie lange eine Sendung ohne erfolgreiche Überprüfung bleiben darf.
- Anfragebudget: Die verfügbare Kapazität nach Berücksichtigung von Wiederholungen, Abgleichen und anderen API-Vorgängen.
Als Planungsbeispiel würden 12.000 einzeln stündlich überprüfte Sendungen vor Wiederholungen 288.000 geplante Suchanfragen pro Tag erzeugen. Eine Überprüfung alle vier Stunden würde 72.000 erzeugen. Dies sind beispielhafte Berechnungen, keine Anbietergrenzen oder empfohlenen Intervalle; Bündelung und Push-Zustellung würden die Berechnung verändern.
Wählen Sie das längste Intervall, das das Aktualitätsziel des Prozesses erfüllt, und prüfen Sie anschließend, ob die vorgelagerten Daten aktuell genug sind, damit dieses Intervall sinnvoll ist.
2. Ändern Sie das Intervall, wenn die Sendung ihren Status ändert
Ein einheitlicher Zeitplan ignoriert das Verhalten von Sendungen. Ein Paket, das auf seinen ersten Scan wartet, eines auf einem langen Transportabschnitt und eines kurz vor der Zustellung benötigen nicht unbedingt dieselbe Aufmerksamkeit.
| Sendungsstatus | Vorgeschlagener Planungsansatz | Schutzmaßnahme |
|---|---|---|
| Warten auf erste Informationen des Transportdienstleisters | Führen Sie begrenzte Überprüfungen durch und verlängern Sie das Intervall, wenn sich nichts ändert. | Behandeln Sie fehlende Scans allein nicht als Beweis für einen Sendungsfehler. |
| Normaler Transport | Verwenden Sie das Basisintervall für den jeweiligen Dienst oder die jeweilige Route. | Halten Sie eine maximale Abgleichslücke ein. |
| Kurz vor der Zustellung | Erwägen Sie kürzere Intervalle, wenn zeitnahe Aktualisierungen eine konkrete Aktion unterstützen. | Messen Sie, ob zusätzliche Anfragen neue Informationen liefern. |
| Ausnahme oder längere Inaktivität | Priorisieren Sie die Untersuchung und verwenden Sie einen begrenzten Überwachungsplan. | Schnelleres Abfragen behebt die zugrunde liegende Ausnahme nicht. |
| Zugestellt oder anderweitig abgeschlossen | Entfernen Sie die Sendung nach Ihren Abschlussprüfungen aus der routinemäßigen Abfrage. | Berücksichtigen Sie Korrekturen und berechtigtes Wiedereröffnen. |
Ordnen Sie Anbieterstatus ausdrücklich Ihrem internen Lebenszyklus zu. Gehen Sie nicht davon aus, dass eine zurückgesendete Sendung, ein fehlgeschlagener Zustellversuch und eine abgeschlossene Zustellung alle die Überwachung beenden sollten. Sie können unterschiedliche betriebliche Entscheidungen erfordern.
Speichern Sie für jede Sendung einen Zeitstempel für die nächste zulässige Überprüfung und berechnen Sie ihn neu, wenn wichtige Ereignisse eintreffen. Dadurch wird die Planung nachvollziehbar und Sie vermeiden einen Timer, der jeden Datensatz gleich behandelt.
3. Verwenden Sie Webhooks für Änderungen, wenn der Anbieter sie unterstützt
Beim Abfragen wird geprüft, ob sich etwas geändert hat. Ein Webhook ermöglicht es einem Anbieter, Ihre Anwendung zu benachrichtigen, sobald eine Aktualisierung verfügbar ist. Wenn die erforderlichen Ereignisse und das Zustellungsverhalten unterstützt werden, verwenden Sie Push-Zustellung als primären Weg zur Datenaufnahme, statt wiederholt jede aktive Sendung abzufragen.
Webhooks beseitigen vorgelagerte Verzögerungen nicht. Außerdem entstehen Anforderungen an die Zustellungsverarbeitung. Prüfen Sie vor der Implementierung den dokumentierten Authentifizierungsmechanismus, Bestätigungsregeln, Wiederholungsverhalten und die Ereigniskennungen des Anbieters.
- Authentifizieren Sie eingehende Anfragen mit dem dokumentierten Verfahren.
- Speichern Sie eine gültige Benachrichtigung dauerhaft oder stellen Sie sie in eine Warteschlange, bevor Sie den erfolgreichen Empfang bestätigen.
- Verarbeiten Sie Benachrichtigungen idempotent, damit eine wiederholte Zustellung keine doppelten Kundennachrichten auslöst.
- Verarbeiten Sie verzögerte und nicht in der richtigen Reihenfolge eintreffende Ereignisse, ohne einen neueren Status mit älteren Informationen zu überschreiben.
- Überwachen Sie Verarbeitungsfehler und das Alter der in der Warteschlange befindlichen Benachrichtigungen.
Gehen Sie nicht davon aus, dass Webhook-Zustellungen genau einmal oder immer chronologisch erfolgen, sofern der Anbieter dies nicht ausdrücklich garantiert. Halten Sie den Ereignisverlauf der Sendung getrennt von ihrem aktuellen normalisierten Status, damit verspätete Informationen bewertet und nicht blind angewendet werden.
4. Fügen Sie einen gezielten Abgleich statt einer zweiten vollständigen Abfrageschleife hinzu
Auch eine webhookbasierte Integration benötigt einen Wiederherstellungsweg. Ihr Endpunkt könnte nicht verfügbar sein, ein Worker könnte nach dem Empfang ausfallen oder ein interner Zuordnungsfehler könnte verhindern, dass eine Aktualisierung den Auftrag erreicht.
Beim Abgleich wird geprüft, ob Ihr gespeicherter Status mit dem Status des Anbieters übereinstimmt. Er sollte sich auf Datensätze konzentrieren, die eine Überprüfung benötigen, statt häufige Abfragen für die gesamte Sendungsmenge erneut einzurichten.
Geeignete Kandidaten für den Abgleich sind Sendungen mit fehlgeschlagener Benachrichtigungsverarbeitung, Datensätze, die die maximale Überprüfungslücke überschritten haben, und von einem bekannten Ausfall betroffene Sendungen. Ein altes Ereignis des Transportdienstleisters allein ist nicht zwangsläufig ein Hinweis auf eine verpasste Aktualisierung.
Stellen Sie nach einem Ausfall betroffene Datensätze in die Warteschlange und arbeiten Sie sie innerhalb eines kontrollierten Anfragebudgets ab. Entfernen Sie überlappende Wiederherstellungsaufgaben und brechen Sie redundante Arbeiten ab, wenn eine erfolgreiche Aktualisierung die Abweichung bereits behoben hat. Vermeiden Sie eine gleichzeitige Anfrage für jede aktive Sendung.
Verfolgen Sie den Zeitstempel der letzten erfolgreich verifizierten Prüfung getrennt vom Zeitstempel des neuesten Ereignisses. Andernfalls kann sich ein Paket ohne aktuellen Scan wiederholt für den Abgleich qualifizieren, obwohl Ihr System gerade bestätigt hat, dass der Anbieter keine neuen Informationen hat.
5. Cachen Sie Tracking-Daten und teilen Sie Anfragen zwischen Verbrauchern
Eine Tracking-Seite, ein Support-Dashboard, ein Benachrichtigungs-Worker und ein Auftragssystem können dieselbe Sendung anfordern. Stellen Sie ihnen einen gemeinsamen Anwendungsdatensatz bereit, statt jeden Verbraucher den Tracking-Anbieter unabhängig abfragen zu lassen.
Speichern Sie den zuletzt bekannten Sendungsstatus lokal zusammen mit der Abrufzeit und relevanten Zeitstempeln der Ereignisse. Lassen Sie Ihren Scheduler oder Webhook-Handler diesen Datensatz aktualisieren. Das Aktualisieren einer Seite durch einen Kunden sollte nicht automatisch eine weitere vorgelagerte Anfrage erzwingen.
Verwenden Sie neben Caching auch Request-Coalescing: Wenn mehrere Verbraucher gleichzeitig denselben veralteten Datensatz anfordern, lassen Sie eine Aktualisierung zu und die anderen deren Ergebnis verwenden oder abwarten. Legen Sie Cache-Schlüssel und Zugriffskontrollen korrekt fest, damit Daten keine Kontogrenzen überschreiten können.
Wenn ein Endpunkt HTTP-Validatoren wie ETag oder Last-Modified unterstützt, können bedingte Anfragen die Übertragung des Antworttextes reduzieren. Eine bedingte Anfrage ist jedoch weiterhin eine Anfrage und kann weiterhin auf das Kontingent des Anbieters angerechnet werden. Die HTTP-Caching-Semantik ist in RFC 9111 definiert; die Unterstützung eines bestimmten Tracking-Endpunkts muss separat geprüft werden.
Machen Sie die Aktualität in der Benutzeroberfläche verständlich. „Zuletzt geprüft“ sollte den Abruf beschreiben, während „Neuestes Sendungsereignis“ das Ereignis des Transportdienstleisters beschreiben sollte. Die Darstellung eines Zeitstempels, als würde er beides repräsentieren, kann Kunden irreführen.
6. Bündeln Sie geeignete Abrufe und verteilen Sie Anfragen über die Zeit
Wenn der relevante Abruf-Endpunkt mehrere Tracking-Datensätze pro Anfrage unterstützt, kann Bündelung die Anzahl der HTTP-Anfragen reduzieren. Prüfen Sie, ob der benötigte Vorgang Bündelung unterstützt: Eine gebündelte Registrierung bedeutet nicht automatisch einen gebündelten Abruf.
Unterscheiden Sie außerdem zwischen Transporteffizienz und Abrechnung. Eine HTTP-Anfrage mit mehreren Datensätzen kann abhängig von den Regeln des Anbieters weiterhin mehrere Kontingenteinheiten oder abrechenbare Abrufe verbrauchen.
Ein praktischer Scheduler sollte:
- Datensätze auswählen, deren Zeitpunkt für die nächste zulässige Überprüfung erreicht ist.
- Abgeschlossene, pausierte oder bereits in der Warteschlange befindliche Datensätze ausschließen.
- Geeignete Datensätze innerhalb der dokumentierten Endpunkt- und Nutzlastgrenzen gruppieren.
- Die Arbeit über einen gemeinsamen Rate-Limiter ausführen.
- Das Ergebnis jedes Elements erfassen und nur fehlgeschlagene oder ungelöste Elemente, sofern angemessen, erneut versuchen.
Verteilen Sie die Arbeit über das Planungsfenster, statt jeden Auftrag zur vollen Stunde auszuführen. Fügen Sie einen begrenzten zufälligen Versatz hinzu, der oft als Jitter bezeichnet wird, um synchronisierte Spitzen zu reduzieren. Halten Sie den Versatz klein genug, um das Aktualitätsziel jedes Prozesses einzuhalten.
Bündelung ist weniger sinnvoll, wenn das Warten auf eine vollständige Gruppe eine dringende Aktualisierung verzögern würde. Lassen Sie zeitkritische Arbeiten ohne vollständige Gruppe fortfahren, halten Sie sie jedoch innerhalb desselben Gesamtratenbudgets.
7. Reagieren Sie auf Ratenbegrenzungen, Fehler und Prüfungen mit geringem Nutzen
Ihr normales Aktualisierungsintervall sollte nicht gleichzeitig Ihr Fehlerwiederholungsintervall sein. Ein nicht verfügbarer Endpunkt benötigt kontrollierte Wiederholungen und keine weitere vollständige Welle geplanter Anfragen zusätzlich zu den Fehlern.
HTTP 429 bedeutet „Too Many Requests“, und die Antwort kann ein Retry-After-Feld enthalten, wie in RFC 6585 beschrieben. Die HTTP-Semantik des Feldes ist in RFC 9110 definiert. Befolgen Sie die geltenden Anweisungen des Anbieters und einen gültigen Retry-After-Wert, sofern dieser angegeben ist. Verwenden Sie andernfalls für wiederholbare Fehler einen begrenzten exponentiellen Backoff mit Jitter.
Wiederholen Sie Authentifizierungsfehler oder ungültige Tracking-Eingaben nicht unbegrenzt. Leiten Sie sie zur Korrektur weiter. Bei Vorgängen, die den serverseitigen Status ändern, müssen Sie die Sicherheit einer Wiederholung bestätigen, bevor Sie eine Anfrage nach einem mehrdeutigen Timeout automatisch erneut senden.
Passen Sie das normale Abfragen separat an. Wenn wiederholte erfolgreiche Prüfungen keine neuen Informationen liefern, sollten Sie das Intervall innerhalb der Aktualitätsgrenzen der Sendung verlängern. Wenn ein wichtiges Ereignis das Paket in eine zeitkritischere Phase verschiebt, verkürzen Sie es wieder.
Wenden Sie die Ratenbegrenzung auf alle Worker an, die dasselbe relevante Kontingent nutzen. Unabhängige Worker-Limits können jeweils regelkonform erscheinen, während ihr kombinierter Datenverkehr eine kontobezogene Grenze überschreitet.
Aktualität und Effizienz gemeinsam validieren
Testen Sie die Richtlinie an einer kontrollierten Gruppe von Sendungen, bevor Sie sie allgemein anwenden. Vergleichen Sie Prozesse mit ähnlichen Merkmalen bei Transportdienstleister, Route und Lebenszyklus, damit eine veränderte Sendungszusammensetzung nicht fälschlich als Planungsverbesserung erscheint.
- Ertrag nützlicher Aktualisierungen: Der Anteil erfolgreicher Prüfungen, die bedeutende Informationen hinzufügen.
- Verifizierungsalter: Zeit seit der letzten erfolgreichen Prüfung des Anbieterstatus.
- Aufnahmeverzögerung: Zeit von der Verfügbarkeit beim Anbieter bis zum Empfang durch die Anwendung, sofern der Verfügbarkeitszeitpunkt beobachtbar ist.
- Anfragelast: Anfragevolumen, Antworten mit Ratenbegrenzung, Wiederholungen und Warteschlangentiefe.
- Wiederherstellungsqualität: Durch Abgleich wiederhergestellte verpasste Änderungen und die zum Beheben von Fehlern benötigte Zeit.
Bezeichnen Sie die Zeit vom Ereignis des Transportdienstleisters bis zur Aufnahme nicht als reine Integrationsverzögerung. Sie kann Verzögerungen bei vorgelagerter Veröffentlichung und Erfassung enthalten, die Ihre Anwendung nicht direkt steuern kann. Eine erfolgreiche Richtlinie reduziert unnötige Abrufe und hält gleichzeitig betrieblich wichtige Änderungen innerhalb der festgelegten Aktualitätsziele.
FAQ
Welches Abfrageintervall eignet sich am besten für die Sendungsverfolgung?
Es gibt kein universelles Intervall. Wählen Sie es anhand des Aktualitätsziels des Prozesses, des vorgelagerten Aktualisierungsverhaltens, der API-Limits und des Anfragebudgets. Beginnen Sie mit einer dokumentierten Basis, messen Sie den Nutzen erfolgreicher Prüfungen und passen Sie das Intervall nach Lebenszyklusstatus an, statt jede Sendung schneller abfragen zu lassen.
Erzwingt das Aktualisieren einer Tracking-Seite eine neue Abfrage beim Transportdienstleister?
Nicht unbedingt. Die Seite kann den Anwendungscache oder die gespeicherten Tracking-Daten des Anbieters lesen. Eine Browseraktualisierung, ein API-Abruf und eine vorgelagerte Aktualisierung beim Transportdienstleister sind unterschiedliche Vorgänge. Bezeichnen Sie eine Aktualisierung nur dann als live, wenn das dokumentierte Verhalten diese Aussage unterstützt.
Können Webhooks das Abfragen vollständig ersetzen?
Sie können einen großen Teil der routinemäßigen Abfragen ersetzen, wenn der Anbieter die erforderlichen Aktualisierungen unterstützt. Behalten Sie für Fehler und unklaren Status einen begrenzten Abgleichsprozess bei. Wie viel Überprüfung weiterhin erforderlich ist, hängt von Zustellungsgarantien, Wiederherstellungsoptionen und den Folgen einer verpassten Aktualisierung ab.
Wann sollten Tracking-Anfragen nach der Zustellung beendet werden?
Entfernen Sie zugestellte Sendungen nach Abschluss Ihrer Abschlussprüfungen aus der routinemäßigen aktiven Abfrage. Entscheiden Sie, ob ein begrenzter Überprüfungszeitraum durch Ihren Prozess und das Verhalten des Anbieters gerechtfertigt ist. Bewahren Sie die Möglichkeit zur Verarbeitung von Korrekturen, ohne jede abgeschlossene Sendung auf einem unbefristeten Zeitplan zu belassen.
Senken weniger HTTP-Anfragen immer die API-Kosten?
Nein. Die Abrechnung kann von Sendungen, Tracking-Datensätzen, Vorgängen oder einer anderen vertraglichen Einheit abhängen und nicht von der Anzahl der HTTP-Anfragen. Bestätigen Sie die geltenden Messregeln, bevor Sie Bündelung, Caching oder die Einführung von Webhooks finanzielle Einsparungen zuschreiben.
Quellen
- Übersicht der 17TRACK Tracking API — offizieller Ausgangspunkt für die Bewertung der Tracking-Integration.
- 17TRACK API-Dokumentation — Referenz zur Überprüfung unterstützter Vorgänge und Integrationsanforderungen vor der Konfiguration der anwendungsseitigen Planung.
- RFC 9110: HTTP Semantics — Semantik von HTTP-Methoden, bedingte Anfragen und Retry-After.
- RFC 9111: HTTP Caching — Cache-Verhalten und Antwortvalidierung.
- RFC 6585: Additional HTTP Status Codes — Definition der Antwort 429 Too Many Requests.


