Cómo utilizar App Connect con HTTP

Un caso de ejemplo empresarial

Su empresa tiene previsto organizar un evento al aire libre de una semana de duración, con una previsión de asistencia de miles de personas. Configure el evento en su aplicación de venta de entradas para que los posibles asistentes puedan reservar entradas. Cuando cada asistente se registre, querrás enviarle un correo electrónico con más detalles sobre el evento. Y como el evento es al aire libre, querrás ayudar a los asistentes a vestirse adecuadamente para el clima incluyendo un pronóstico del tiempo para cada día que reserven. Pero estás muy ocupado, por lo que quieres una forma rápida de asegurarte de que cada asistente reciba la previsión pertinente.

¿Cómo App Connect ayudar?

Utiliza App Connect para configurar un flujo que consulte la API del tiempo y, a continuación, utilice la respuesta para añadir detalles sobre la previsión meteorológica a los correos electrónicos generados cada vez que un asistente se inscriba en tu evento. Al automatizar este proceso, podrá concentrarse en organizar un evento de primera categoría que impresione a sus asistentes.

Lo primero que hay que tener en cuenta

Si el HTTP servidor se encuentra en una red privada (por ejemplo, detrás de un firewall en una ubicación local o en una nube privada), cree una conexión de red privada. App Connect puede utilizar esta conexión de red privada para acceder al HTTP servidor de forma segura. Para más información, consulte Conexión a una red privada.

Conexión a HTTP

Para conectarse App Connect a un HTTP punto final, consulte «Conexión a HTTP » en App Connect.

Consideraciones generales sobre el uso de HTTP en App Connect

• (Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.

  Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación admite eventos configurables, verá un enlace Mostrar más eventos configurables bajo la lista de eventos. Si la aplicación admite la detección dinámica de acciones, verá un enlace Mostrar más debajo de la lista de acciones.

• (Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.
• Tenga en cuenta las siguientes consideraciones para la acción del método Invoke.
  • Los métodos HTTP compatibles son GET, POST, PUT, PATCH, DELETE y HEAD.
  • Se admiten los transportes HTTP y HTTPS, y el URL que especifique debe estar completamente calificado, como se muestra en los siguientes ejemplos.

    http://www.example.com/

    https://host_name:port/path

    https://my_API_URL?query_parameter1=value1&query_parameter2=value2

    URL también puede contener asignaciones de nodos anteriores del flujo. El siguiente ejemplo muestra una Postal/Zip Code asignación que se insertó utilizando Insertar una referencia:

    

    Nota: Si especificó una sustitución URL al conectarse a la HTTP cuenta, el protocolo, el nombre de host y el puerto que especifique en el URL (plenamente cualificado) campo se sustituirán por la configuración de sustitución cuando se ejecute el flujo.
  • Los encabezados de solicitud (si son necesarios para definir parámetros operativos adicionales) pueden especificarse como propiedades de datos (con un nombre y un tipo String de datos) o como un objeto JSON que consta de pares nombre-valor separados por comas.
    • Para especificar los encabezados de solicitud como propiedades de datos, siga estos pasos.
      1. Haga clic en Añadir propiedad para definir cada propiedad con un tipo de datos de String.

         

      2. Haga clic en Editar asignaciones para mostrar estas propiedades como campos y, a continuación, especifique sus valores. (Para añadir o eliminar propiedades, haga clic en Editar propiedades )

         

         Para actualizar el nombre de una propiedad definida, asegúrese de que el campo asociado esté vacío antes de hacer clic en Editar propiedades. Para obtener más información sobre cómo especificar propiedades de datos, consulte Definición de sus propias propiedades de datos.

    • Para especificar cabeceras de solicitud como JSON (por ejemplo {"Accept": "application/json", "Content-Type":"application/json"}), haga clic en Map to object y, a continuación, introduzca el JSON.

      

      Si ya ha definido uno o varios campos de propiedad en el encabezado Encabezados de solicitud, pero prefiere utilizar JSON, elimine las propiedades y haga clic en Asignar a objeto para mostrar un campo Encabezados de solicitud en el que puede escribir.

  • Opcionalmente, implemente su propio manejo de errores dentro del flujo indicando si el flujo continúa si ocurre algo inesperado. Establezca Continuar flujo ( non-2xx ) en true para continuar ejecutando el flujo si la llamada a HTTP devuelve un código de estado distinto de 2xx (Éxito).

    

    Si se establece en false (el valor predeterminado), el procesamiento del flujo se detiene cuando se emite un código de estado non-2xx.

  • Se realiza un máximo de tres intentos de llamada al HTTP servidor, con un retardo de cinco segundos entre los reintentos. Un flujo suele agotarse a los 60 segundos.
  • Dependiendo del formato de los resultados de la prueba, es posible que la vista en árbol de los resultados de la prueba para el HTTP conector no muestre todas las entradas. Utilice la vista de código para ver la entrada y salida JSON completas.

Formas de procesar la HTTP respuesta

La respuesta de un método invocado mediante « HTTP » se devuelve en un formato compatible con el punto final (por ejemplo, JSON [ JavaScript Object Notation], XML o el formato CSV ) y se transmite como una cadena. Para asignar los encabezados y el cuerpo de la respuesta en una acción posterior de tu flujo, utiliza uno de los analizadores integrados de App Connect para convertir la cadena en un objeto que la represente. Por ejemplo, si la respuesta está en formato JSON, puede utilizar el analizador JSON para convertir la cadena JSON en un objeto JSON. Puede asignar la respuesta seleccionando «Encabezados de respuesta» o «Cuerpo de respuesta» para el método « HTTP » / «Invoke» en la lista de entradas disponibles.

Sugerencias sobre resolución de problemas

• Si observa errores de red para una acción del método Invoke HTTP en su flujo, la causa podría estar relacionada con problemas de conectividad o seguridad. Utilice estos consejos como ayuda para la resolución de errores:
  • Compruebe que la red está disponible y que se puede acceder al servidor HTTP servidor. Por ejemplo, el error puede deberse a un tiempo de espera de la red.
  • Si puede llamar correctamente al punto HTTP final utilizando una herramienta API, compruebe que las especificaciones del encabezado de la solicitud en esa herramienta son idénticas a las especificadas en el campo Encabezados de solicitud de su HTTP nodo.
  • Comprueba si el problema se debe a errores en el certificado de SSL. App Connect utiliza el protocolo Transport Layer Security ( TLS ) para establecer un canal de comunicación seguro con el punto final HTTP, y rechaza el certificado que presenta el servidor de destino si se detectan problemas. Por ejemplo, el certificado se rechaza si no es fiable, ha caducado o le faltan certificados intermedios (o de cadena).

    Si consigues conectarte correctamente al punto final HTTP mediante una utilidad externa, comprueba si la verificación de certificados de SSL está habilitada para dicha utilidad. Si no lo está, puedes activarlo y probar la llamada de nuevo para ver si pasa.

  • Para ayudarle a determinar la causa del error, asegúrese de que el campo Continuar flujo ( non-2xx ) esté establecido en true, y luego asigne el código de HTTP estado de respuesta en un nodo posterior del flujo, como se muestra en el siguiente ejemplo.

    A continuación, ejecute de nuevo el flujo y compruebe qué código de estado se devuelve.

• Cuando se emplea el conector HTTP y se especifica el campo de cabecera Request como content-type: application/x-www-form-urlencoded, es necesario proporcionar un conjunto de pares clave-valor en el campo Body correspondiente. Si utiliza el nodo Variable para incorporar variables establecidas anteriormente en el flujo, y alguna de estas variables contiene un símbolo «&», dicho símbolo servirá como separador entre los pares clave-valor. Este separador podría provocar un resultado inesperado en el flujo.
  Por ejemplo, consideremos la siguiente configuración.

  • El encabezado se establece en application/x-www-form-urlencoded y los pares clave-valor del cuerpo se establecen en colors={{$Setvariable.variable.colors}}&pets={{$Setvariable.variable.pets}}.
  • La variable se establece en colors=blue pets=dog&cat.
  • La prueba considera el símbolo «&» como separador y el resultado es "colors": "blue", "dog": "", "pets": "cat".
  Consejo: Para evitar que el símbolo «&» se interprete como separador, utilice la codificación adecuada URL para el carácter «&». Sin embargo, no todos los sitios web admiten este método de codificación.

Eventos y acciones

HTTP eventos

Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.

Su flujo completa estas acciones en esta aplicación.