Eine Integration kann sich erfolgreich mit der UPS API verbinden und später Autorisierungsfehler liefern. Ein abgelaufenes Token ist eine mögliche Ursache. Ein erhaltenes Token gewährt keinen dauerhaften Zugriff.
Wo steht die Gültigkeitsdauer?
Die offizielle UPS-Spezifikation für OAuth Client Credentials enthält in der Antwort das Feld expires_in. Es beschreibt die Gültigkeitsdauer des angeforderten Tokens in Sekunden. Werten Sie den Serverwert aus, statt ihn durch eine früher festgelegte Konstante zu ersetzen.
Was sollte die Integration prüfen?
Die Spezifikation definiert expires_in als Zeichenfolge. Wandeln Sie den Wert für die Ablaufberechnung in eine Zahl um und berücksichtigen Sie Sekunden. Speichern Sie die Dauer zusammen mit dem Token.
Praktisch sinnvoll ist es, vor Ablauf ein neues Token anzufordern und einen kleinen Zeitpuffer für die Anfrage einzuplanen. Das ist eine Empfehlung zur Integration, keine zusätzliche UPS-Frist. Bei mehreren Prozessen sollten Sie prüfen, ob jeder unnötig ein neues Token anfordert.
Ermitteln Sie bei einem Autorisierungsfehler zunächst die Ursache: Der Ablauf ist nicht die einzige Möglichkeit. Vermeiden Sie endlose identische Wiederholungen und schreiben Sie weder Token noch Client-Geheimnisse in gewöhnliche Protokolle.
Für wen ist diese Prüfung relevant?
Für Entwickler von Shops, Versanddiensten und anderen Systemen mit direkter UPS-API-Anbindung. Wer über eine fertige Plattform versendet, muss nicht selbst ein OAuth-Token beschaffen.
Prüfen Sie in einer Testintegration das Anfordern, Wiederverwenden und Ablaufen des Tokens. Ein Dokumentationsbeispiel garantiert keine dauerhaft unveränderte Zugriffsdauer.
Häufige Fragen
Kann für alle Token dieselbe feste Gültigkeitsdauer verwendet werden?
Ersetzen Sie die Serverantwort nicht durch eine Konstante. Verwenden Sie den expires_in-Wert des erhaltenen Tokens.
Welche Einheit verwendet expires_in?
Sekunden. Laut UPS-Spezifikation ist das Feld eine Zeichenfolge. Für Berechnungen muss es in eine Zahl umgewandelt werden.
Muss ein gewöhnlicher Versender selbst ein Token anfordern?
Nein, wenn er eine fertige Versandplattform nutzt. Diese Einstellung betrifft Entwickler mit direkter UPS-API-Anbindung.
