Un’integrazione può collegarsi correttamente alle UPS API e poi iniziare a restituire errori di autorizzazione. Una possibile causa è un token scaduto. Ottenere un token non rende l’accesso permanente.
Dove è indicata la durata?
La specifica ufficiale UPS OAuth Client Credentials include nella risposta il campo expires_in. Descrive la durata del token richiesto in secondi. Va letto il valore restituito dal server, senza sostituirlo con una durata fissa scelta in precedenza.
Cosa controllare nell’integrazione?
Nella specifica expires_in è una stringa. Per calcolare la scadenza, convertite il valore in numero e considerate i secondi. Conservate la durata insieme al token.
Un approccio pratico è ottenere un nuovo token prima della scadenza, lasciando un piccolo margine per la richiesta. È una raccomandazione progettuale, non un’ulteriore scadenza imposta da UPS. Se operano più processi, verificate che ciascuno non richieda inutilmente un nuovo token.
In caso di errore di autorizzazione, individuate prima la causa: la scadenza non è l’unica possibilità. Evitate tentativi identici senza fine e non scrivete token o segreti del client nei normali log.
A chi serve questa verifica?
Agli sviluppatori di negozi, servizi di consegna e altri sistemi che usano direttamente le UPS API. Chi spedisce tramite una piattaforma pronta all’uso non deve ottenere personalmente un token OAuth.
Verificate in un’integrazione di test l’ottenimento del token, il riutilizzo e la gestione della scadenza. Un esempio nella documentazione non garantisce una durata fissa dell’accesso per sempre.
Domande frequenti
Si può usare una durata fissa per tutti i token?
Non sostituite la risposta del server con una costante. Usate il valore expires_in del token ricevuto.
Quale unità usa expires_in?
I secondi. La specifica UPS definisce il campo come stringa: per i calcoli va convertito in numero.
Chi spedisce deve ottenere personalmente un token?
No, se utilizza una piattaforma di spedizione pronta all’uso. Questa configurazione riguarda gli sviluppatori di sistemi collegati direttamente alle UPS API.
