Partilhar via

Adicionar fonte HTTP a um fluxo de eventos (pré-visualização)

Este artigo mostra-lhe como adicionar uma fonte HTTP a um fluxo de eventos.

O conector HTTP fornece uma forma configurável sem código de transmitir dados de qualquer API REST diretamente para o Eventstream para processamento em tempo real. Permite-lhe recolher continuamente dados de plataformas SaaS e feeds públicos de dados e analisar automaticamente as respostas JSON em eventos estruturados. Também oferece feeds públicos de exemplo para o ajudar a começar rapidamente — basta selecionar uma API de exemplo, inserir a chave da API e deixar o Eventstream preencher os cabeçalhos e parâmetros necessários.

Pré-requisitos

  • Um espaço de trabalho com capacidade Fabric ou modo de licença de avaliação.
  • Acesso ao espaço de trabalho com funções de Contribuidor ou funções de nível superior.
  • Se não tiver um eventstream, siga o guia para criar um eventstream.

Adicionar HTTP como fonte

Se ainda não adicionaste nenhuma fonte ao teu event stream, seleciona o mosaico Usar fonte externa .

Captura de ecrã que mostra a seleção do tile para usar uma fonte externa.

Se estiveres a adicionar a fonte a um fluxo de eventos já publicado, muda para o modo Editar. Na fita, selecione Adicionar fonte>Fontes externas.

Captura de ecrã que mostra seleções para adicionar fontes externas.

Procura por http e seleciona Conectar para adicionar o conector HTTP ao teu event stream.

Captura de ecrã que mostra a seleção de HTTP como tipo de origem no assistente Selecionar uma fonte de dados.

Configurar e ligar-se a HTTP

Pode selecionar uma das APIs públicas de exemplo para começar rapidamente com cabeçalhos e parâmetros pré-definidos, ou selecionar Sair para configurar o seu próprio conector HTTP personalizado.

Usar exemplos de APIs públicas

  1. Selecione uma API pública de exemplo para configurar rapidamente o conector HTTP: Captura de ecrã que mostra a página de exemplo da API.

    • Binance. Obtenha o preço mais recente do Bitcoin
    • CoinGecko. Obtenha o preço atual do Bitcoin em USD
    • Transporte para Londres. Obtenha previsões de chegada em direto para uma estação em Londres
    • Alpha Vantage. Obtenha o preço da ação MSFT em tempo real
    • OpenWeather. Obtenha a previsão meteorológica de um local
    • NewsAPI. Obtenha as últimas manchetes de negócios nos EUA

  2. Para APIs que requerem uma chave API, use o link fornecido para solicitar a chave API e inseri-la na caixa de entrada. O conector cria automaticamente a ligação à nuvem Fabric e preenche previamente os cabeçalhos e parâmetros HTTP necessários.

    Importante

    A API de exemplo da Binance não requer uma chave API, mas és responsável por cumprir os seus Termos de Uso.

  3. Se escolher Usar ligação existente, selecione Aplicar exemplo para preencher os cabeçalhos e parâmetros necessários para a API de exemplo sem introduzir uma chave de API.

  4. Alternativamente, selecione Sair para fechar a janela e configure a sua própria fonte HTTP do zero.

Configure a sua própria fonte HTTP

Siga os passos para configurar a sua própria fonte HTTP sem uma API de exemplo.

  1. Crie uma nova conexão. Selecione Nova ligação e introduza as propriedades necessárias para a sua fonte HTTP:

    Captura de ecrã que mostra onde selecionar a nova página de ligação.

    • URL base: O URL base do endpoint HTTP.
    • Token Audience Uri (opcional): O recurso para o qual o token se destina.
    • Nome da conexão: insira um nome para a conexão.
    • Tipo de autenticação: Atualmente, o conector HTTP suporta apenas Anonymous, Basic e API Key autenticação.

    Captura de ecrã que mostra a nova página de ligação.

  2. Método de pedido: Selecionar GET ou POST.

  3. Cabeçalhos e parâmetros: Se selecionou autenticação por Chave API ao criar a ligação à cloud, use o parâmetro dinâmico ${apiKey} nos seus cabeçalhos ou parâmetros para referenciar a Chave API.

    Por exemplo, para se ligar ao CoinGecko, use o cabeçalho: x_cg_demo_api_key = ${apiKey}.

    Importante

    NÃO insira a sua chave API ou outras credenciais nos cabeçalhos ou parâmetros.

  4. Intervalo de pedido(s): Especifica o tempo em segundos de espera entre pedidos consecutivos; O intervalo válido é [1, 3600].

  5. Tentativas máximas: O número máximo de vezes que o conector tenta novamente um pedido quando ocorre um erro; O intervalo válido é [10, 100].

  6. Retentar intervalo (s): O tempo em segundos para esperar após um erro antes do conector retentar; O intervalo válido é [1, 3600].

  7. Código de estado de nova tentativa: Os códigos de erro HTTP retornados que levam o conector a tentar novamente o pedido. Introduza uma lista de códigos separada por vírgulas ou um intervalo de códigos. Os intervalos são especificados com um código de início e um código de fim opcional. Por exemplo:

    • 400- inclui todos os códigos superiores ou iguais a 400.
    • 400-500 inclui códigos de 400 a 500, incluindo 500.
    • 404,408,500- Instrui o conector a reexecutar em caso de 404 NOT FOUND, 408 REQUEST TIMEOUT, e quaisquer códigos de erro 5xx.

    Alguns códigos de estado são sempre repetidos, como não autorizado, tempos limite, e demasiados pedidos.

    Captura de ecrã que mostra as definições configuradas.

  8. Consulte o resumo de configuração da fonte HTTP e selecione Adicionar.

    Captura de ecrã que mostra a página de configuração da avaliação.

Pode ver a fonte HTTP adicionada ao seu fluxo de eventos no modo Editar.

Uma captura de ecrã da fonte HTTP adicionada no modo Editar, com o botão Publicar destacado.

Selecione Publicar para publicar as alterações e comece a transmitir dados da fonte HTTP para o fluxo de eventos.

Uma captura de ecrã da fonte HTTP adicionada na visualização ao vivo com o botão Publicar destacado.

Limitação

  • Atualmente, o conector HTTP suporta apenas respostas da API JSON .
  • A autenticação OAuth não é suportada.
  • A fonte HTTP não suporta funcionalidades CI/CD, incluindo Git Integration e Pipeline de Implementação. Exportar ou importar um item Eventstream que inclua esta fonte através do Git pode resultar em erros.

Conteúdo relacionado

Outros conectores:

  • Last updated on