Adición manual de una API

SE APLICA A: Todos los niveles de API Management

En este artículo se muestra cómo agregar manualmente una API a Azure API Management. Cuando quiera crear respuestas ficticias a partir de la API, puede crear una API en blanco. Para obtener información sobre cómo crear respuestas de API simulada, consulte Respuestas de API simulada.

Si desea importar una API existente, consulte la sección Contenido relacionado de este artículo.

En este artículo, aprenderá a crear una API en blanco. Especificará httpbin.org (un servicio de pruebas público) como UNA API de back-end.

Requisitos previos

• Complete el inicio rápido Creación de una instancia de Azure API Management.

Vaya a la instancia de API Management

1. En Azure Portal, busque y seleccione Servicios de API Management:

   

2. En la página Servicios de API Management , seleccione la instancia de API Management:

   

Creación de una API

1. En API en el menú de la izquierda, seleccione API.

2. Seleccione + Agregar API.

3. Seleccione el icono HTTP :

   

4. Escriba la dirección URL del servicio web de back-end (por ejemplo, https://httpbin.org) y otras opciones de configuración de la API. Los valores de configuración se explican en el tutorial Importación y publicación de la primera API.

5. Seleccione Crear.

En este momento, no tiene ninguna operación en API Management que se asigne a las operaciones en la API de back-end. Si llama a una operación que se expone a través del back-end, pero no a través de API Management, obtendrá un error 404.

Adición y prueba de una operación

En esta sección se muestra cómo agregar una /get operación para asignarla a la operación de back-end http://httpbin.org/get .

Agregar una operación

1. Seleccione la API que creó en los pasos anteriores.
2. Seleccione + Agregar operación.
3. En DIRECCIÓN URL, seleccione GET y escriba /get en el cuadro de texto.
4. En Nombre para mostrar, escriba FetchData.
5. Seleccione Guardar.

Prueba de la operación

Pruebe la operación en Azure Portal. (También puede probarlo en el portal para desarrolladores).

1. Seleccione la pestaña Prueba.
2. Seleccione FetchData.
3. Seleccione Enviar.

La respuesta que genera la http://httpbin.org/get operación aparece en la sección respuesta HTTP . Si desea transformar las operaciones, consulte Transformación y protección de una API.

Adición y prueba de una operación con parámetros

En esta sección se explica cómo agregar una operación que toma un parámetro. En este ejemplo, asigna la operación a http://httpbin.org/status/200.

Agregar una operación

1. Seleccione la API que creó anteriormente.
2. En la pestaña Diseño, seleccione + Agregar operación.
3. En DIRECCIÓN URL, seleccione GET y escriba /status/{code} en el cuadro de texto.
4. En Nombre para mostrar, escriba GetStatus.
5. Seleccione Guardar.

Prueba de la operación

Pruebe la operación en Azure Portal. (También puede probarlo en el portal para desarrolladores).

1. Seleccione la pestaña Prueba.

2. Seleccione GetStatus. En el código, escriba 200.

3. Seleccione Enviar.

   La respuesta que genera la http://httpbin.org/status/200 operación aparece en la sección respuesta HTTP . Si desea transformar las operaciones, consulte Transformación y protección de una API.

Adición y prueba de una operación con caracteres comodín

En esta sección se indica cómo agregar una operación con caracteres comodín. Una operación de comodín te permite pasar un valor arbitrario en una solicitud de API. En lugar de crear operaciones GET independientes como se muestra en las secciones anteriores, podría crear una operación GET con caracteres comodín.

Agregar una operación

1. Seleccione la API que creó anteriormente.
2. En la pestaña Diseño, seleccione + Agregar operación.
3. En DIRECCIÓN URL, seleccione GET y escriba /* en el cuadro de texto.
4. En Nombre para mostrar, escriba WildcardGet.
5. Seleccione Guardar.

Prueba de la operación

Pruebe la operación en Azure Portal. (También puede probarlo en el portal para desarrolladores).

1. Seleccione la pestaña Prueba.

2. Seleccione WildcardGet. Pruebe las operaciones GET que ha probado en secciones anteriores o pruebe otra operación GET compatible.

   Por ejemplo, en Parámetros de plantilla, cambie el valor situado junto al carácter comodín (*) nombre a encabezados. La operación devuelve los encabezados HTTP de la solicitud entrante.

3. Seleccione Enviar.

   La respuesta que genera la http://httpbin.org/headers operación aparece en la sección respuesta HTTP . Si desea transformar las operaciones, consulte Transformación y protección de una API.

Anexión de otras API

Puede crear una API fuera de las API expuestas por diferentes servicios, entre las que se incluyen:

• Una especificación de OpenAPI
• Una API SOAP
• Una GraphQL API
• Una aplicación web hospedada en Azure App Service
• Funciones de Azure
• Azure Logic Apps
• Azure Service Fabric

Para anexar una API a una API existente:

1. Vaya a la instancia de Azure API Management en Azure Portal:

   

2. Seleccione API en la página Información general o seleccione API >API en el menú de la izquierda.

   

3. Seleccione los puntos suspensivos (...) junto a la API que desea anexar a otra API.

4. Seleccione Importar en el menú desplegable:

   

5. Seleccione un servicio desde el que se va a importar una API.

Contenido relacionado

• Limitaciones de importación de API
• Importación de una especificación de OpenAPI
• Importación de una API de SOAP
• Importación de una API SOAP y conversión en REST
• Importación de App Service API
• Importación de una API de aplicación de contenedor
• Importación de WebSocket API
• Importación de GraphQL API
• Importación de un esquema GraphQL y configuración de solucionadores de campos
• Importación de una API de aplicación de funciones
• Importación de una API de aplicación lógica
• Importación de un servicio Service Fabric
• Importación de una API de Azure AI Foundry
• Importación de una API de Azure OpenAI
• Importación de una API de LLM
• Importación de una API de OData
• Importación de metadatos de SAP OData
• Importación de una API de gRPC
• Edición de una API