Una integración puede conectarse correctamente a UPS API y después empezar a devolver errores de autorización. Un token caducado es una posible causa. Obtenerlo no convierte el acceso en permanente.
¿Dónde se indica la duración?
La especificación oficial de UPS OAuth Client Credentials incluye el campo expires_in en la respuesta. Describe la duración del token solicitado en segundos. Utilice el valor devuelto por el servidor en vez de sustituirlo por una duración fija elegida anteriormente.
¿Qué revisar en la integración?
La especificación define expires_in como una cadena de texto. Conviértala en número al calcular la caducidad y tenga en cuenta los segundos. Guarde la duración junto con el token.
Una solución práctica es obtener un token nuevo antes de la caducidad, con un pequeño margen para realizar la solicitud. Es una recomendación de integración, no un plazo adicional impuesto por UPS. Si hay varios procesos, compruebe que no soliciten cada uno un token nuevo innecesariamente.
Ante un error de autorización, identifique primero la causa: la caducidad no es la única posibilidad. Evite reintentos idénticos sin fin y no escriba tokens ni secretos de cliente en los registros habituales.
¿A quién corresponde esta revisión?
A desarrolladores de tiendas, servicios de entrega y otros sistemas que utilizan UPS API directamente. Quien envía mediante una plataforma preparada no necesita obtener personalmente un token OAuth.
Compruebe en una integración de pruebas la obtención, reutilización y caducidad del token. Un ejemplo de documentación no garantiza una duración fija del acceso para siempre.
Preguntas frecuentes
¿Puede usarse una duración fija para todos los tokens?
No sustituya la respuesta del servidor por una constante. Utilice el valor expires_in del token recibido.
¿Qué unidad utiliza expires_in?
Segundos. La especificación UPS define el campo como una cadena de texto, por lo que debe convertirse en número para calcular.
¿Un remitente habitual debe obtener personalmente un token?
No, si utiliza una plataforma de envíos preparada. Esta configuración corresponde a desarrolladores de sistemas que usan UPS API directamente.
