Tutorial: Simulación de respuestas de API

SE APLICA A: todos los niveles de API Management

Las API de back-end se importan en una API de Azure API Management o se crean y administran manualmente. Los pasos de este tutorial describen cómo:

• Use API Management para crear una API HTTP en blanco.
• Administre manualmente una API HTTP.
• Establezca una directiva en una API para que devuelva una respuesta ficticia.

Este método permite a los desarrolladores continuar con la implementación y las pruebas de la instancia de API Management incluso si el back-end no está disponible para enviar respuestas reales.

Sugerencia

Los equipos de API pueden usar esta característica en áreas de trabajo. Las áreas de trabajo proporcionan acceso administrativo aislado a las API y sus propios entornos de tiempo de ejecución de API.

La capacidad de crear respuestas ficticias es útil en muchos escenarios:

• Cuando la fachada de la API está diseñada primero y la implementación de back-end se produce más adelante, o cuando el back-end se está desarrollando en paralelo.
• Cuando el back-end no está operativo temporalmente o no puede escalar.

En este tutorial, aprenderá a:

• Creación de una API de prueba
• Adición de una operación a la API de prueba
• Habilitación de la simulación de respuesta
• Probar la API simulada

Requisitos previos

• Obtenga información sobre la terminología de API Management.
• Comprenda el concepto de directivas en API Management.
• Complete el inicio rápido Creación de una instancia de Azure API Management.

Creación de una API de prueba

En los pasos de esta sección se muestra cómo crear una API HTTP sin back-end.

1. Inicie sesión en Azure Portal y, después, vaya a la instancia de API Management.

2. Seleccione APIs>+ Agregar API>HTTP tile:

   

3. En la ventana Crear una API HTTP, seleccione Completa.

4. En Nombre para mostrar, escriba Test API.

5. En Productos, seleccione Ilimitado, si ese valor está disponible. Este valor solo está disponible en algunos niveles. Puede dejar el valor en blanco para este tutorial, pero debe asociar la API a un producto para publicarlo. Para más información, consulte Importación y publicación de la primera API.

6. En Puertas de enlace, seleccione Administrado si esta opción está disponible. (Esta opción es avaiable solo en determinados niveles de servicio).

7. Seleccione Crear.

   

Adición de una operación a la API de prueba

Una API expone una o varias operaciones. En esta sección, agregará una operación a la API HTTP que creó. Al llamar a la operación después de completar los pasos de esta sección, se desencadena un error. Después de completar los pasos en la sección Habilitar simulación de respuesta, no encontrará ningún error.

Portal

1. Seleccione la API que creó en el paso anterior.

2. Seleccione + Agregar operación.

3. En la ventana Front-end , escriba los valores siguientes:

   Configuración	Valor	Descripción
   Nombre para mostrar	Llamada de prueba	Nombre que se muestra en el portal para desarrolladores.
   URL (primer cuadro)	GET	Seleccione uno de los verbos HTTP predefinidos.
   Dirección URL (segundo cuadro)	/test	Una ruta de URL para la API.
   Descripción		Descripción opcional de la operación. Proporciona documentación en el portal para desarrolladores a los desarrolladores que usan la API.

   

4. Seleccione la pestaña Respuestas, que se encuentra en los cuadrosURL, Nombre para mostrar y Descripción . Escribirá valores en esta pestaña para definir códigos de estado de respuesta, tipos de contenido, ejemplos y esquemas.

5. Seleccione + Agregar respuesta y, a continuación, seleccione 200 Aceptar en la lista.

   

6. En la sección Representaciones , seleccione + Agregar representación.

7. Escriba application/json en el cuadro de búsqueda y seleccione el tipo de contenido application/json .

8. En el cuadro Ejemplo , escriba { "sampleField" : "test" }.

9. Seleccione Guardar.

   

Aunque no es necesario para este ejemplo, puede configurar más opciones para una operación de API en otras pestañas, como se describe en la tabla siguiente:

Pestaña	Descripción
Consulta	Agregue parámetros de consulta. Además de proporcionar un nombre y una descripción, puede especificar valores que se asignan a un parámetro de consulta. Puede marcar uno de los valores como predeterminado (opcional).
Solicitud	Defina esquemas, ejemplos y tipos de contenido de solicitud.

CLI de Azure

Para empezar a usar la CLI de Azure:

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Para agregar una operación a la API de prueba, ejecute el comando az apim api operation create:

az apim api operation create --resource-group <resource-group> \
    --display-name "Test call" --api-id test-api --method GET \
    --url-template /test --service-name <API-management-service-name> 

Ejecute el comando az apim api operation list para ver todas las operaciones de una API:

az apim api operation list --resource-group <resource-group-name> \
    --api-id test-api --service-name <API-management-service-name> --output table

Mantenga esta operación para utilizarla en el resto de este artículo. Si desea quitar una operación, puede usar el comando az apim api delete . Obtenga el identificador de operación del comando anterior.

az apim api operation delete --resource-group <resource-group-name> \
    --api-id test-api --operation-id <ID> \
    --service-name <API-management-service-name>

Habilitación de la simulación de respuesta

1. Seleccione la API que creó en Creación de una API de prueba.

2. Asegúrese de que la pestaña Diseño está seleccionada.

3. Seleccione la operación de prueba que agregó.

4. En la sección Procesamiento de entrada, seleccione + Agregar directiva.

   

5. Seleccione el icono Respuestas simulada de la galería:

   

6. Asegúrese de que 200 Correcto, aplicación/json aparece en el cuadro de respuesta de API Management. Esta selección indica que la API debe devolver el ejemplo de respuesta que definió en la sección anterior.

   

7. Seleccione Guardar.

   Sugerencia

   Aparece una barra amarilla que muestra el texto Simulación está habilitada . Este mensaje indica que las respuestas devueltas desde API Management se simulan mediante la directiva de simulación y no las genera el back-end.

Probar la API simulada

1. Seleccione la API que creó en Creación de una API de prueba.

2. En la pestaña Prueba , asegúrese de que está seleccionada la API de llamada de prueba y, a continuación, seleccione Enviar para realizar una llamada de prueba:

   

3. La respuesta HTTP muestra el JSON proporcionado como ejemplo en la primera sección del tutorial:

   

Paso siguiente

Vaya al siguiente tutorial:

Transformación y protección de una API publicada