Une intégration peut se connecter correctement à UPS API puis renvoyer des erreurs d’autorisation. Un jeton expiré est une cause possible. Obtenir un jeton ne rend pas l’accès permanent.
Où la durée est-elle indiquée ?
La spécification officielle UPS OAuth Client Credentials inclut le champ expires_in dans la réponse. Il décrit la durée de validité du jeton demandé en secondes. Utilisez la valeur renvoyée par le serveur plutôt qu’une durée fixe choisie auparavant.
Que vérifier dans l’intégration ?
La spécification définit expires_in comme une chaîne de caractères. Convertissez-la en nombre pour calculer l’expiration et tenez compte des secondes. Conservez cette durée avec le jeton.
Une approche pratique consiste à obtenir un nouveau jeton avant l’expiration, avec une petite marge pour la requête. C’est une recommandation de conception, pas un délai supplémentaire imposé par UPS. Si plusieurs processus fonctionnent ensemble, vérifiez qu’ils ne demandent pas chacun un nouveau jeton inutilement.
En cas d’erreur d’autorisation, identifiez d’abord la cause : l’expiration n’est pas la seule possibilité. Évitez les répétitions identiques sans fin et ne consignez ni jetons ni secrets client dans les journaux ordinaires.
Qui doit effectuer cette vérification ?
Les développeurs de boutiques, services de livraison et autres systèmes utilisant directement UPS API. Un expéditeur passant par une plateforme prête à l’emploi n’a pas à obtenir lui-même un jeton OAuth.
Testez l’obtention du jeton, sa réutilisation et l’expiration dans une intégration de test. Un exemple de documentation ne garantit pas une durée d’accès définitivement fixe.
Questions fréquentes
Peut-on utiliser une durée fixe pour tous les jetons ?
Ne remplacez pas la réponse du serveur par une constante. Utilisez la valeur expires_in du jeton reçu.
Quelle unité utilise expires_in ?
Les secondes. La spécification UPS définit ce champ comme une chaîne de caractères : convertissez-le en nombre pour les calculs.
Un expéditeur doit-il obtenir lui-même un jeton ?
Non, s’il utilise une plateforme de livraison prête à l’emploi. Ce réglage concerne les développeurs de systèmes utilisant directement UPS API.
