Compartir a través de

Adición de un origen HTTP a una secuencia de eventos (versión preliminar)

En este artículo se muestra cómo agregar un origen HTTP a una secuencia de eventos.

El conector HTTP proporciona una manera no codificada y configurable de transmitir datos desde cualquier API REST directamente a Eventstream para el procesamiento en tiempo real. Permite extraer continuamente datos de plataformas SaaS y fuentes de distribución de datos públicas y analizar automáticamente las respuestas JSON en eventos estructurados. También ofrece fuentes públicas de ejemplo que le ayudarán a empezar a trabajar rápidamente: simplemente seleccione una API de ejemplo, escriba la clave de API y deje que Eventstream prellene los encabezados y parámetros necesarios.

Prerrequisitos

  • Un área de trabajo con capacidad de Fabric o modo de licencia de prueba.
  • Acceso al área de trabajo con roles de trabajo de Contribuidor o superior.
  • Si no tiene una secuencia de eventos, siga la guía para crear una secuencia de eventos.

Adición de HTTP como origen

Si aún no ha agregado ningún origen a la secuencia de eventos, seleccione el icono Usar origen externo .

Captura de pantalla que muestra la selección del icono para usar un origen externo.

Si estás agregando el origen a una secuencia de eventos ya publicada, cambia al modo Edición. En la cinta de opciones, seleccione Agregar origen>Fuentes externas.

Captura de pantalla que muestra las selecciones para agregar orígenes externos.

Busque http y seleccione Conectar para agregar el conector HTTP a la secuencia de eventos.

Captura de pantalla que muestra la selección de HTTP como tipo de origen en el Asistente para seleccionar un origen de datos.

Configuración y conexión a HTTP

Puede seleccionar una de las API públicas de ejemplo para empezar a trabajar rápidamente con los encabezados y parámetros predefinidos, o bien seleccionar Salir para configurar su propio conector HTTP personalizado.

Uso de API públicas de ejemplo

  1. Seleccione una API pública de ejemplo para configurar rápidamente el conector HTTP: captura de pantalla que muestra la página de API de ejemplo.

    • Binance. Obtener el último precio de Bitcoin
    • CoinGecko. Obtener el precio actual de Bitcoin en USD
    • Transporte para Londres. Obtener predicciones de llegada en directo para una estación de Londres
    • Alpha Vantage. Obtención del precio de acciones de MSFT en tiempo real
    • OpenWeather. Obtener la previsión meteorológica de una ubicación
    • NewsAPI. Obtenga los últimos titulares empresariales en EE. UU.

  2. En el caso de las API que requieren una clave de API, use el vínculo proporcionado para solicitar la clave de API y escríbala en el cuadro de entrada. A continuación, el conector crea automáticamente la conexión en la nube de Fabric y rellena los encabezados y parámetros HTTP necesarios.

    Importante

    La API de ejemplo de Binance no requiere una clave de API, pero usted es responsable de cumplir con sus Términos de uso.

  3. Si elige Usar conexión existente, seleccione Aplicar ejemplo para rellenar previamente los encabezados y parámetros necesarios para la API de ejemplo sin escribir una clave de API.

  4. Como alternativa, seleccione Salir para cerrar la ventana y configurar su propio origen HTTP desde cero.

Configuración de su propio origen HTTP

Siga los pasos para configurar su propio origen HTTP sin una API de ejemplo.

  1. Cree una conexión. Seleccione Nueva conexión y escriba las propiedades necesarias para el origen HTTP:

    Captura de pantalla que muestra dónde seleccionar la nueva página de conexión.

    • Dirección URL base: la dirección URL base del punto de conexión HTTP.
    • URI de audiencia de token (opcional): recurso al que está destinado el token.
    • Nombre de la conexión: escriba un nombre para esta conexión.
    • Tipo de autenticación: actualmente, el conector HTTP solo admite Anonymous, Basic y API Key.

    Captura de pantalla que muestra la nueva página de conexión.

  2. Método de solicitud: seleccione GET o POST.

  3. Encabezados y parámetros: si seleccionó autenticación de clave de API al crear la conexión en la nube, use el parámetro dinámico ${apiKey} en los encabezados o parámetros para hacer referencia a la clave de API.

    Por ejemplo, para conectarse a CoinGecko, use el encabezado : x_cg_demo_api_key = ${apiKey}.

    Importante

    No escriba la clave de API ni otras credenciales en los encabezados o parámetros.

  4. Intervalo de solicitud (s):especifica el tiempo en segundos para esperar entre solicitudes consecutivas; el intervalo válido es [1, 3600].

  5. Número máximo de reintentos: el número máximo de veces que el conector vuelve a intentar una solicitud cuando se produce un error; el intervalo válido es [10, 100].

  6. Retroceso de reintento (s): el tiempo en segundos que se espera después de un error antes de que el conector vuelva a intentarlo; el rango válido es [1, 3600].

  7. Código de estado de reintento: los códigos de error HTTP devueltos que solicitan al conector que vuelva a intentar la solicitud. Escriba una lista separada por comas de códigos o intervalo de códigos. Los intervalos se especifican con un código de inicio y finalización opcional. Por ejemplo:

    • 400- incluye todos los códigos mayores o iguales a 400.
    • 400-500 incluye códigos del 400 al 500, incluido el 500.
    • 404,408,500- solicita al conector que vuelva a intentarlo en 404 NOT FOUND, 408 REQUEST TIMEOUT y todos los códigos de error 5xx.

    Algunos códigos de estado siempre se reintentan, como no autorizados, tiempos de espera y demasiadas solicitudes.

    Captura de pantalla que muestra los valores configurados.

  8. Revise el resumen de configuración del origen HTTP y seleccione Agregar.

    Captura de pantalla que muestra la página de configuración de revisión.

Puede ver el origen HTTP agregado a la secuencia de eventos en modo de edición.

Captura de pantalla del origen HTTP agregado en modo de edición con el botón Publicar resaltado.

Seleccione Publicar para publicar los cambios y empezar a transmitir datos desde el origen HTTP al flujo de eventos.

Captura de pantalla del origen HTTP agregado en la vista dinámica con el botón Publicar resaltado.

Limitación

  • Actualmente, el conector HTTP solo admite respuestas de API JSON .
  • No se admite la autenticación de OAuth.
  • El origen HTTP no admite características de CI/CD, incluida la integración de Git y la canalización de implementación. La exportación o importación de un elemento Eventstream que incluya este origen a través de Git puede producir errores.

Contenido relacionado

Otros conectores:

  • Last updated on