Capacitación para clientes sobre la virtualización de sandbox de la API

¿Qué es la virtualización de sandbox?

La virtualización de sandbox de la API es un servicio que simula el comportamiento de una instancia en vivo de sandbox. Nuestro servicio virtualizado proporciona una experiencia consistente en la que la respuesta que recibes está predefinida y no siempre varía en función de los valores de entrada específicos que proporcionas.

Aquí hay un ejemplo. Supongamos que realizas varias llamadas con la misma solicitud de tarifa, cambiando la ubicación del remitente y del destinatario en cada prueba. La API arrojará la misma respuesta de tarifa predefinida, independientemente de los cambios de dirección. Aunque los valores pueden no coincidir, la estructura de la respuesta simularía lo que recibirías en el entorno en vivo.

Dado que el servicio virtualizado no afecta los componentes del sistema backend, las pruebas de integración están protegidas de las dependencias backend, al tiempo que obtienes la respuesta adecuada.

¿Qué es la virtualización de sandbox de FedEx?

En un sistema complejo e interdependiente como FedEx, lamentablemente hay pocos casos en los que un recurso dependiente deja de estar disponible y la disponibilidad del sistema se ve afectada. Cuando estos incidentes ocurren, aunque sean remotos, podrían afectar negativamente tus pruebas de integración de la API. Existen otras restricciones en las instancias en vivo que también podrían restringir el alcance de tus pruebas de integración. Algunos ejemplos incluyen:

• La cuenta de envío no tiene acceso requerido para probar cierto escenario específico.
• Disponibilidad limitada de datos de prueba.
• Tiempo de inactividad del sistema planificado o no planificado.

¿Cómo puedes utilizar la instancia de sandbox virtualizada?

• Familiarízate con la documentación de la API, los puntos finales y el método de autenticación. Esto ayudará a diseñar pruebas efectivas.
• Descarga y familiarízate con la colección JSON de la API proporcionada en la documentación de la API.
• Elige y prueba transacciones de prueba que se ajusten a tus escenarios de uso. Para obtener una experiencia consistente, evita cambiar la estructura de la solicitud de carga útil para recibir la respuesta virtualizada.
• Ten en cuenta que no todos los valores de entrada afectarán la respuesta. En su lugar, céntrate en entender cómo gestiona tu aplicación las respuestas consistentes.
• Prueba que todas las API tengan un comportamiento adecuado de acuerdo con la documentación. Incluye casos de prueba positivos y negativos.
• Utiliza los casos de prueba negativos proporcionados para comprender cómo se devuelven los mensajes de error y los códigos de estado. Esto te ayudará a determinar cómo es que tu aplicación debe gestionar los errores. Consulta la colección JSON de la API y los casos de prueba con el prefijo añadido como «Negativo».

Beneficios de la virtualización

• Menos probabilidades de que los recursos no estén disponibles.
• Menor dependencia en los datos de prueba.
• Respuesta más rápida en comparación con la instancia de sandbox en vivo.
• No se requiere acceso explícito a nivel de cuenta para los servicios especiales.
• Experiencia de integración sin problemas que facilita el proceso de pruebas y certificación.

Preguntas frecuentes

1. ¿Cómo puedo hacer que la solicitud de carga útil llegue a la respuesta virtualizada?
   En la documentación de cada API se proporciona la colección de JSON de la API. Visita el catálogo de API y abre la documentación de la API.Consulta la sección «Colección JSON de la API» en la documentación de la API. Esta recolección de cartero tiene guardadas todas las solicitudes de cargas útiles que arrojaría la respuesta virtualizada.
2. ¿Necesito obtener el token para acceder a la instancia de sandbox virtualizada?
   Sí, la generación del token y la autorización van a funcionar tal y como están, y se espera que ingreses el token para cada transacción que interactúe con el servicio sandbox virtualizado.
3. ¿Cómo puedo saber si la respuesta procede de un servicio virtualizado o de una instancia en vivo?
   La respuesta virtualizada tendría la siguiente alerta añadida como parte de la carga útil.
   
   
4. En la API de Tarifas y tiempo en tránsito, ¿por qué no se valida mi dirección en la solicitud de carga útil?
   La validación de direcciones no es parte de la lógica que deriva una respuesta de tarifa virtualizada. Solo se valida el país, por lo que puede ingresar cualquier valor en el resto de los campos de dirección.
5. ¿Están virtualizadas todas las API?
   Hasta la fecha, solo se han virtualizado las siguientes API. Estamos trabajando para virtualizar el resto de las capacidades de la API.