Implementación y llamada a API personalizadas desde flujos de trabajo de Azure Logic Apps

  • Artículo

Se aplica a: Azure Logic Apps (consumo)

Después de crear sus propias API para usarlas en los flujos de trabajo de la aplicación lógica, debe implementarlas para poder invocarlas. Puede implementar las API como aplicaciones web, pero considere la posibilidad de implementarlas como aplicaciones de API, lo que puede facilitarle su trabajo al compilar, hospedar y consumir API en la nube y en el entorno local. No tiene que cambiar ningún código en las API; basta con implementar el código en una aplicación de API. Puede hospedar las API en Azure App Service, una oferta de plataforma como servicio (PaaS) que proporciona hospedaje API fácil y altamente escalable.

Aunque se puede llamar a cualquier API desde el flujo de trabajo de una aplicación lógica, para lograr una experiencia óptima, agregue metadatos de Swagger que describan las operaciones y los parámetros de la API. Este documento de Swagger facilita que la API se integre con más facilidad y funcione mejor con el flujo de trabajo de aplicación lógica.

Implementación de la API como aplicación web o aplicación de API

Para poder llamar a su API personalizada desde un flujo de trabajo de aplicación lógica, impleméntela como aplicación web o aplicación de API en Azure App Service. Para mejorar la legibilidad del documento de Swagger en el flujo de trabajo, establezca las propiedades de definición de la API y active el uso compartido de recursos entre orígenes (CORS) para la aplicación web o de API.

  1. En Azure Portal, seleccione la aplicación web o de API.

  2. En el menú que se abre, en API, seleccione Definición de la API. Establezca Ubicación de la definición de la API en la dirección URL del archivo swagger.json.

    Por lo general, la dirección URL aparece en este formato: https://{name}.azurewebsites.net/swagger/docs/v1)

    Captura de pantalla que muestra el Azure Portal con el panel «API definition» con la aplicación web y la caja de la «definición de la ubicación de API» para la URL para el documento de Swagger para su API personalizada.

  3. Bajo API, seleccione CORS. Establezca la directiva ORS para Orígenes permitido en "*" (permitir todos).

    Esta configuración permite solicitudes del diseñador de flujo de trabajo.

    Captura de pantalla que muestra el panel de aplicación web de «CORS» con «Orígenes permitidos» «*», que los permite todos.

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

Llamada a la API personalizada desde flujos de trabajo de aplicación lógica

Después de configurar las propiedades de definición de la API y de CORS, los desencadenadores y las acciones de la API personalizada deberían estar disponibles para incluirlos en el flujo de trabajo de la aplicación lógica.

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

  • Para ver las acciones y entradas disponibles señalando a un documento de Swagger, use la acción HTTP + Swagger.

  • Para llamar a cualquier API, incluso aquellas que no tengan ni expongan un documento de Swagger, siempre puede crear una solicitud con la acción HTTP.

Pasos siguientes