Hop til hovedindhold

Web.Contents

Returnerer det indhold, der er downloadet fra URL-adressen, som binært.

Syntax​

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

Remarks​

Returnerer det indhold, der er downloadet fra url som binært. Der kan angives en valgfri postparameter, options, for at angive yderligere egenskaber. Posten kan indeholde følgende felter:

  • Query : Føj forespørgselsparametre til URL-adressen via programmering uden at skulle bekymre dig om udslip.
  • ApiKeyName : Hvis destinationswebstedet har et begreb for en API-nøgle, kan denne parameter bruges til at angive navnet (ikke værdien) for den nøgleparameter, der skal bruges i URL-adressen. Den faktiske nøgleværdi angives i legitimationsoplysningerne.
  • Headers : Hvis denne værdi angives som en post, leveres der yderligere overskrifter til en HTTP-anmodning.
  • Timeout : Hvis du angiver denne værdi som en varighed, ændres timeout for en HTTP-anmodning. Standardværdien er 100 sekunder.
  • ExcludedFromCacheKey : Hvis denne værdi angives som en liste, udelades disse HTTP-overskriftsnøgler i beregningen af cachelagringsdata.
  • IsRetry : Hvis du angiver denne logiske værdi som true, ignoreres alle eksisterende svar i cachen, når data hentes.
  • ManualStatusHandling : Hvis du angiver denne værdi som en liste, forhindres eventuel indbygget håndtering af HTTP-anmodninger, hvis svar har én af disse statuskoder.
  • RelativePath : Hvis du angiver denne værdi som tekst, føjes den til basis-URL-adressen, før anmodningen foretages.
  • Content : Hvis denne værdi angives, ændres webanmodningen fra en GET til en POST ved hjælp af værdien for indstillingen som indholdet i POST.
HTTP-anmodningen foretages enten som en GET (når der ikke er angivet noget indhold) eller et POST (når der er Indhold). POST-anmodninger kan kun foretages anonymt.
Overskrifterne i HTTP-svaret er tilgængelige som metadata på det binære resultat. Uden for en brugerdefineret dataforbindelseskontekst er kun et undersæt af svarheadere tilgængelige (af sikkerhedsmæssige årsager).

Examples​

Example #1​

Hent indholdet af <code>"https://bing.com/search?q=Power+Query&#34;&lt;/code> ved hjælp af indstillinger RelativePath og forespørgsel. Disse indstillinger kan bruges til dynamisk forespørgsel på en statisk URL-basisadresse.

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

Result:

binary

Example #2​

Udfør et POST mod en webadresse, videregiver et binært JSON-nyttedata, og parser svaret som JSON.

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

Result:

table

Example #3​

Opret forbindelse til en sikker URL-adresse, der accepterer en godkendelsesnøgle som en del af forespørgselsstrengen. I stedet for at fastlægge den hemmelige nøgle i M (hvilket ville udgøre en sikkerhedsrisiko) kan nøglen leveres sikkert ved at angive dens navn (ikke dens værdi) i M, med at vælge Web API-godkendelse og angive nøgleværdien som en del af legitimationsoplysninger for Web API. Når det bruges på denne måde, genererer følgende eksempel en anmodning til <code>"https://contoso.com/api/customers/get?api_key=\*\*\*\*\*&#34;&lt;/code>.

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

Result:

binary

Category​

Accessing data