Zdieľať cez

Web.Contents

  • Článok

Syntax

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

O

Vráti obsah stiahnutý z url ako binárny údaj. Ak chcete určiť ďalšie vlastnosti, možno zadať voliteľný parameter záznamu options. Záznam môže obsahovať nasledujúce polia:

  • Query: Programovaním pridajte parametre dotazu do URL adresy bez toho, aby ste sa museli obávať o zadávanie úniku údajov.
  • ApiKeyName: Ak má cieľová lokalita koncept kľúča rozhrania API, tento parameter možno použiť na určenie názvu kľúča (nie hodnoty) parametra kľúča, ktorý sa musí použiť v URL adrese. Skutočná hodnota kľúča je zadaná v prihlasovacom údajoch.
  • Headers: Určením tejto hodnoty ako záznamu sa do požiadavky HTTP dodajú ďalšie hlavičky.
  • Timeout: Ak určíte túto hodnotu ako trvanie, zmení sa časový limit požiadavky HTTP. Predvolená hodnota je 100 sekúnd.
  • ExcludedFromCacheKey: Ak zadáte túto hodnotu ako zoznam, vylúčia sa tieto kľúče hlavičiek HTTP a nebudú viac súčasťou výpočtu pre ukladanie údajov do vyrovnávacej pamäte.
  • IsRetry: Ak zadáte túto logickú hodnotu ako true, budú sa pri načítaní údajov ignorovať všetky existujúce odpovede vo vyrovnávacej pamäti.
  • ManualStatusHandling: Ak zadáte túto hodnotu ako zoznam, zabráni sa akémukoľvek vstavanému spracovávaniu pre požiadavky HTTP, ktorých odpoveď má jeden z týchto kódov stavu.
  • RelativePath: Ak zadáte túto hodnotu ako text, tento text sa pripojí k základnej URL adrese pred vytvorením požiadavky.
  • Content: Určením tejto hodnoty sa zmení webová žiadosť z metódy GET na metódu POST, pričom ako obsah metódy POST sa použije hodnota možnosti.

Požiadavka HTTP sa vykoná buď ako GET (ak nie je zadaný žiaden obsah) alebo POST (ak existuje obsah). Žiadosti o uverejnenie môžu byť vykonané len anonymne.

Hlavičky odpovede HTTP sú k dispozícii ako metaúdaje v binárnom výsledku. Mimo kontextu vlastného konektora údajov je k dispozícii iba podmnožina hlavičiek odpovede (z bezpečnostných dôvodov).

Príklad č. 1

Načítajte obsah "https://bing.com/search?q=Power+Query" pomocou možností RelativePath a Query. Tieto možnosti možno použiť na dynamické dotazovanie statickej základnej URL adresy.

používania

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

výstupu

binary

Príklad č. 2

Vykonajte UVEREJNENIE na URL adrese, odovzdaním binárnej údajovej časti JSON a analýzou odpovede vo formáte JSON.

používania

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

výstupu

table

Príklad č. 3

Pripojte sa k zabezpečenej URL adrese, ktorá prijíma overovací kľúč ako súčasť reťazca dotazu. Namiesto pevného kódovania tajného kľúča v jazyku M (ktoré by predstavovalo bezpečnostné riziko) možno kľúč bezpečne poskytnúť zadaním jeho názvu (nie jeho hodnoty) v M, výberom overovania webového rozhrania API a zadaním hodnoty kľúča ako súčasť poverenia webového rozhrania API. Pri použití týmto spôsobom sa vygeneruje požiadavka na "https://contoso.com/api/customers/get?api_key=******".

používania

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

výstupu

binary

Ďalšie informácie

spracovanie kódu stavu so Web.Contents vo vlastných konektoroch