Les på engelsk

Del via


Web.Contents

Syntaks

 
Web.Contents(url as text, optional options as nullable record) as binary

Om

Returnerer innholdet som lastes ned fra url som binært. En valgfri postparameter, options, kan angi flere egenskaper. Posten kan inneholde følgende felt:

  • Query: Legg programmatisk til spørringsparametere i nettadressen uten å måtte bekymre deg for å slippe unna.
  • ApiKeyName: Hvis målområdet har en forestilling om en API-nøkkel, kan denne parameteren brukes til å angi navnet (ikke verdien) for nøkkelparameteren som må brukes i URL-adressen. Den faktiske nøkkelverdien angis i legitimasjonen.
  • Headers: Hvis du angir denne verdien som en post, får du flere overskrifter til en HTTP-forespørsel.
  • Timeout: Hvis du angir denne verdien som en varighet, endres tidsavbruddet for en HTTP-forespørsel. Standardverdien er 100 sekunder.
  • ExcludedFromCacheKey: Hvis du angir denne verdien som en liste, utelates disse HTTP-topptekstnøklene fra å være en del av beregningen for hurtigbufring av data.
  • IsRetry: Hvis du angir denne logiske verdien som sann, ignoreres alle eksisterende svar i hurtigbufferen når du henter data.
  • ManualStatusHandling: Hvis du angir denne verdien som en liste, forhindres innebygd håndtering for HTTP-forespørsler hvis svar har én av disse statuskodene.
  • RelativePath: Hvis du angir denne verdien som tekst, føyer den til den grunnleggende URL-adressen før du foretar forespørselen.
  • Content: Hvis du angir denne verdien, endres webforespørselen fra GET til et INNLEGG ved hjelp av verdien for alternativet som innhold i POST.

HTTP-forespørselen gjøres enten som en GET (når det ikke er angitt innhold) eller et INNLEGG (når det er innhold). POST-forespørsler kan bare gjøres anonymt.

Topptekstene i HTTP-svaret er tilgjengelige som metadata for det binære resultatet. Utenfor en egendefinert datakoblingskontekst er bare et delsett av svaroverskrifter tilgjengelig (av sikkerhetsgrunner).

Eksempel 1

Hent innholdet i "https://bing.com/search?q=Power+Query" ved hjelp av alternativene RelativePath og Query. Disse alternativene kan brukes til dynamisk spørring av en statisk basis-NETTADRESSE.

bruk

let
    searchText = "Power Query"
in
    Web.Contents(
        "https://www.bing.com",
        [
            RelativePath = "search",
            Query = [q = searchText]
        ]
    )

utdata

binary

Eksempel 2

Utfør et INNLEGG mot en NETTADRESSE, send en binær JSON-nyttelast og analyser svaret som JSON.

bruk

let
    url = ...,
    headers = [#"Content-Type" = "application/json"],
    postData = Json.FromValue([x = 235.7, y = 41.53]),
    response = Web.Contents(
        url,
        [
            Headers = headers,
            Content = postData
        ]
    ),
    jsonResponse = Json.Document(response)
in
    jsonResponse

utdata

table

Eksempel 3

Koble til en sikker URL-adresse som godtar en godkjenningsnøkkel som en del av spørringsstrengen. I stedet for å hardkode den hemmelige nøkkelen i M (som ville utgjøre en sikkerhetsrisiko), kan nøkkelen gis sikkert ved å angi navnet (ikke verdien) i M, velge web-API-godkjenning og skrive inn nøkkelverdien som en del av web-API-legitimasjonen. Når det brukes på denne måten, vil eksemplet nedenfor generere en forespørsel om å "https://contoso.com/api/customers/get?api_key=******".

bruk

Web.Contents("https://contoso.com/api/customers/get", [ApiKeyName="api_key"])

utdata

binary

Mer informasjon

Statuskodebehandling med Web.Contents i egendefinerte koblinger