Cómo añadir números de seguimiento a un webhook
Para añadir un número de seguimiento a su suscripción de webhook mediante la Advanced Integrated Visibility Tracking Number Subscription API, siga estos pasos:
- Cree un proyecto de Suscripción de número de seguimiento de Advanced Integrated Visibility siguiendo los pasos de la sección anterior o los pasos que figuran en la guía de inicio.
- Necesita un token OAuth para iniciar llamadas de la API de Suscripción de número de seguimiento de Advanced Integrated Visibility. Para generar el token OAuth, use la Authorization API. En la documentación de Authorization API del catálogo de API podrá ver los pasos detallados para generar un token OAuth.
- Haga clic en la opción Detalles del proyecto del menú de navegación de la izquierda. En la pestaña Claves de producción, baje hasta encontrar la documentación de la API Suscripción de número de seguimiento de Advanced Integrated Visibility.
Una vez acceda a la documentación de la API Suscripción de número de seguimiento de Advanced Integrated Visibility, encontrará tres puntos de conexión:
Punto de conexión Vinculación de números de seguimiento
- Use este punto de conexión para añadir o eliminar números de seguimiento a una determinada suscripción a webhook. Encontrará más información en la documentación de la API Suscripción de número de seguimiento de Advanced Integrated Visibility.
- Cualquier adición o eliminación de números de seguimiento es un trabajo asincrónico. Se envía un ID del trabajo como respuesta para añadir o eliminar una llamada a la Tracking Number Association API.
Punto de conexión Detalles del trabajo de números de seguimiento
Este punto de conexión ofrece detalles sobre un determinado ID de trabajo, como cuántos números de seguimiento se han añadido correctamente a una determinada suscripción a webhook, o cuántos siguen procesándose.
Punto de conexión Estado del trabajo de números de seguimiento
Este punto de conexión te permite obtener un resumen actual de todos los trabajos que se están procesando.
- Use el token AUTH generado en el paso 2 con el punto de conexión Vinculación de números de seguimiento para añadir números de seguimiento a la suscripción a webhook.
Normas de validación:
- El nombre del webhook debe ser exclusivo.
- La URL de destino del webhook debe estar en formato sintáctico estandarizado.
- Los campos obligatorios para crear un webhook no pueden estar vacíos.
- Debe asociarse al menos un número de cuenta de envío de FedEx para crear un webhook.
- Para una validación satisfactoria:
- Al crear un webhook correctamente, el cliente recibirá un mensaje de confirmación.
Ejemplo de mensaje de confirmación: <<Nombre del webhook>> se ha creado correctamente. Los cambios podrían tardar hasta 10 minutos en aplicarse.
- Al crear un webhook correctamente, el cliente recibirá un mensaje de confirmación.
- Para una validación insatisfactoria/fallida:
- Si FedEx recibe una respuesta que no sea 200 (OK) o 202 (Accepted), la validación de la URL de destino del webhook se considerará fallida.
Response