Del via

Tilføj HTTP-kilde til en eventstream (forhåndsvisning)

Denne artikel viser dig, hvordan du tilføjer en HTTP-kilde til en eventstream.

HTTP-connectoren giver en no-code, konfigurerbar måde at streame data fra ethvert REST-API direkte ind i Eventstream til realtidsbehandling. Det giver dig mulighed for kontinuerligt at hente data fra SaaS-platforme og offentlige datafeeds og automatisk parse JSON-svar til strukturerede begivenheder. Den tilbyder også eksempler på offentlige feeds, der hjælper dig hurtigt i gang – vælg blot et eksempel-API, indtast din API-nøgle, og lad Eventstream forududfylde de nødvendige headers og parametre.

Prerequisites

  • Et arbejdsområde med Fabric-kapacitet eller prøvelicens-tilstand .
  • Adgang til arbejdsområdet med bidragyder eller højere arbejdsområderoller.
  • Hvis du ikke har en eventstream, så følg guiden for at oprette en eventstream.

Tilføj HTTP som kilde

Hvis du endnu ikke har tilføjet nogen kilde til din eventstream, vælg flisen Brug ekstern kilde.

Skærmbillede, der viser valget af flisen til brug af en ekstern kilde.

Hvis du tilføjer kildekoden til en allerede offentliggjort eventstream, så skift til Rediger-tilstand . På båndet skal du vælge Tilføj kilde>Eksterne kilder.

Skærmbillede, der viser valg til tilføjelse af eksterne kilder.

Søg efter http, og vælg Connect for at tilføje HTTP-connectoren til din eventstream.

Skærmbillede, der viser valget af HTTP som kildetype i guiden Vælg en datakilde.

Konfigurér og forbind til HTTP

Du kan vælge et af de offentlige eksempler på API'er for hurtigt at komme i gang med foruddefinerede headers og parametre, eller vælge Exit for at konfigurere din egen brugerdefinerede HTTP-connector.

Brug eksempler på offentlige API'er

  1. Vælg et eksempel på et offentligt API for hurtigt at opsætte HTTP-connectoren: Skærmbillede, der viser eksempel på API-side.

    • Binance. Få den seneste Bitcoin-pris
    • CoinGecko. Få den aktuelle Bitcoin-pris i USD
    • Transport til London. Få live ankomstprognoser for en station i London
    • Alpha Vantage. Få MSFT-aktiekursen i realtid
    • OpenWeather. Få vejrudsigten for et sted
    • NewsAPI. Få de seneste erhvervsnyheder i USA

  2. For API'er, der kræver en API-nøgle, brug det medfølgende link til at ansøge om API-nøglen og indtast den i inputboksen. Connectoren opretter derefter automatisk Fabric-cloud-forbindelsen og forududfylder de nødvendige HTTP-headere og parametre.

    Vigtig

    Binance-eksempel-API'en kræver ikke en API-nøgle, men du er ansvarlig for at overholde dens brugsvilkår.

  3. Hvis du vælger Brug eksisterende forbindelse, vælg Anvend eksempel for at forududfylde de nødvendige headers og parametre for eksempel-API'en uden at indtaste en API-nøgle.

  4. Alternativt kan du vælge Luk for at lukke vinduet og konfigurere din egen HTTP-kilde fra bunden.

Konfigurer din egen HTTP-kilde

Følg trinene for at konfigurere din egen HTTP-kilde uden et eksempel-API.

  1. Skab en ny forbindelse. Vælg Ny forbindelse og indtast de nødvendige egenskaber for din HTTP-kilde:

    Skærmbillede, der viser, hvor man vælger den nye forbindelsesside.

    • Base URL: Den grundlæggende URL til HTTP-endpointet.
    • Token-publikum Uri (valgfrit): Den ressource, tokenet er tiltænkt.
    • Forbindelsesnavn: Indtast et navn til forbindelsen.
    • Autentificeringstype: I øjeblikket understøtter AnonymousHTTP-connectoren kun , Basic, og API Key autentificering.

    Skærmbillede, der viser den nye forbindelsesside.

  2. Anmodningsmetode: Vælg GET eller POST.

  3. Headere og parametre: Hvis du valgte API-nøgleautentificering , da du oprettede cloud-forbindelsen, skal du bruge den dynamiske parameter ${apiKey} i dine headere eller parametre til at referere til API-nøglen.

    For eksempel, for at forbinde til CoinGecko, brug headeren: x_cg_demo_api_key = ${apiKey}.

    Vigtig

    Indskriv IKKE din API-nøgle eller andre oplysninger i headers eller parametre.

  4. Anmodningsinterval(er): Angiver tiden i sekunder til ventetid mellem på hinanden følgende anmodninger; gyldigt interval er [1,3600].

  5. Maksimale gentagelser: Det maksimale antal gange, forbindelsen prøver en anmodning igen, når der opstår en fejl; gyldigt interval er [10, 100].

  6. Prøv backoff (s) igen: Tiden i sekunder til at vente efter en fejl, før stikket prøver igen; gyldigt interval er [1,3600].

  7. Prøv statuskode: HTTP-fejlkoderne returnerede forbindelsen, som beder connectoren om at prøve anmodningen igen. Indtast en komma-separeret liste af koder eller et kodeområde. Intervaller angives med en start- og en valgfri slutkode. Eksempel:

    • 400- inkluderer alle koder større end eller lig med 400.
    • 400-500 inkluderer koder fra 400 til 500, inklusive 500.
    • 404,408,500- beder stikket om at prøve igen på 404 IKKE FUNDET, 408 ANMODNING TIMEOUT og alle 5xx fejlkoder.

    Nogle statuskoder bliver altid prøvet igen, såsom uautoriserede, timeouts og for mange anmodninger.

    Skærmbillede, der viser de konfigurerede indstillinger.

  8. Gennemgå konfigurationsoversigten for HTTP-kilden og vælg Tilføje.

    Skærmbillede, der viser siden for gennemgangskonfiguration.

Du kan se HTTP-kilden tilføjet til din eventstream i redigeringstilstand.

Et screenshot af den tilføjede HTTP-kilde i Redigeringstilstand med Publicér-knappen markeret.

Vælg Publish for at offentliggøre ændringerne og begynde at streame data fra HTTP-kilden til eventstreamen.

Et screenshot af den tilføjede HTTP-kildekode i Live View med Publicer-knappen markeret.

Begrænsning

  • HTTP-connectoren understøtter i øjeblikket kun JSON API-svar.
  • OAuth-autentificering understøttes ikke.
  • HTTP-kilden understøtter ikke CI/CD-funktioner, herunder Git Integration og Deployment Pipeline. Eksport eller import af et Eventstream-element, der inkluderer denne kilde, via Git kan resultere i fejl.

Relateret indhold

Andre connectors:

  • Last updated on