Compartir a través de

Llame a sus propias API web y API REST desde flujos de trabajo en Azure Logic Apps

Se aplica a: Azure Logic Apps (Consumo + Estándar)

Cuando tenga api web o API REST existentes a las que quiera llamar desde flujos de trabajo en Azure Logic Apps, primero debe completar algunos pasos de configuración antes de poder llamar a estas API. Principalmente, debe implementar las API como aplicaciones web o aplicaciones de API. Para realizar esta tarea, hospede las API en Azure App Service, una plataforma en la nube que proporciona hospedaje de API muy escalable y fácil.

En App Service, puede implementar las API como aplicaciones web, pero considere la posibilidad de implementar las API como aplicaciones de API en su lugar. Este enfoque facilita el trabajo al compilar, hospedar y consumir API en la nube y en entornos locales. No tiene que cambiar ningún código de las API para implementarlo en una aplicación de API.

Puede llamar a cualquier API desde un flujo de trabajo, pero para obtener la mejor experiencia, agregue metadatos de Swagger a la aplicación web o a la aplicación de API. En este documento de Swagger se describen las operaciones y los parámetros de api, lo que ayuda a que los flujos de trabajo de la aplicación lógica funcionen mejor y más fácilmente con la API. También debe configurar el uso compartido de recursos entre orígenes (CORS) en la aplicación web o la aplicación de API para que el flujo de trabajo pueda acceder a la API.

En esta guía se muestra cómo agregar un documento de Swagger, configurar CORS para la aplicación web o la aplicación de API y proporcionar opciones para llamar a la API desde un flujo de trabajo después de completar la implementación y el hospedaje de la API en App Service.

Para obtener más información, consulte:

Prerrequisitos

Adición de acceso de Swagger y CORS a la aplicación web o a la aplicación de API

Al agregar un documento de Swagger a la aplicación web o a la aplicación de API, el diseñador de flujos de trabajo de Azure Logic Apps puede encontrar y mostrar más fácilmente las operaciones y los parámetros disponibles en la API. También debe configurar el uso compartido de recursos entre orígenes (CORS) en la aplicación web o la aplicación de API para que el flujo de trabajo pueda acceder a la API.

Para que el documento Swagger sea legible desde su flujo de trabajo en el diseñador, en su aplicación web o aplicación de API, configure las propiedades de definición de API y el acceso CORS.

  1. En Azure Portal, busque y abra el recurso aplicación web o aplicación de API.

  2. En la barra lateral del recurso de la aplicación, seleccione Información general.

  3. En la pestaña Propiedades , en Dominios, desde la propiedad Dominio predeterminado , copie y guarde el nombre del sitio web en algún lugar del paso siguiente.

  4. En la barra lateral del recurso de la aplicación, en API, seleccione Definición de API. En Ubicación de definición de API, escriba la dirección URL del archivo JSON de Swagger, que normalmente usa el siguiente formato, pero puede diferir si el archivo swagger usa una especificación de API más reciente:

    https://<website-name>/swagger/docs/v1

    En el ejemplo siguiente se muestra una dirección URL de Swagger con la especificación de API más reciente:

    La captura de pantalla muestra el Azure Portal, la página de definición de la API de la aplicación web y la URL del documento Swagger de la API.

  5. Cuando finalices, selecciona Guardar.

  6. En la barra lateral del recurso de la aplicación, en API, seleccione CORS.

  7. En Origen permitido, establezca la directiva CORS en "*", lo que significa permitir todo.

    Esta configuración permite solicitudes del diseñador de flujos de trabajo en Azure Logic Apps.

    Recorte de pantalla mostrando el panel CORS de la aplicación web con Orígenes permitidos establecido en *, lo que permite todos los orígenes.

  8. En la barra de herramientas, seleccione Guardar.

Para más información, consulte Hospedaje de una API RESTful con CORS en Azure App Service.

Llamada a la API desde el flujo de trabajo

Una vez que configuras la URL de definición de API y CORS, las operaciones de la API aparecen en la galería de conectores para que puedas encontrarlas y agregarlas a tu flujo de trabajo.

  • Para ver los sitios web que tienen direcciones URL de OpenAPI, puede examinar los sitios web de suscripción en el diseñador de flujos de trabajo.

  • Para ver las acciones y entradas disponibles al mirar un documento de Swagger, puede usar el desencadenador o la acción HTTP + Swagger.

  • Para llamar a cualquier API, incluidas las API que no tienen o exponen un documento de Swagger, siempre puede crear una solicitud con la acción HTTP.

Contenido relacionado

  • Last updated on