Web.Contents

Syntax

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

Informácie

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

• Query: Programovaním pridajte parametre dotazu do URL adresy bez toho, aby ste sa museli starať 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 pridajú ď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číta obsah "https://bing.com/search?q=Power+Query" s použitím RelativePath možností a Query . Tieto možnosti možno použiť na dynamické dotazovanie statickej základnej URL adresy.

Použitie

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

Výkon

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žitie

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ýkon

table

Príklad č. 3

Pripojenie na zabezpečenú URL adresu, ktorá prijíma overovací kľúč ako súčasť svojho 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. Ak sa použije týmto spôsobom, nasledujúci príklad vygeneruje požiadavku na "https://contoso.com/api/customers/get?api_key=******".

Použitie

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

Výkon

binary

Ďalšie informácie

Spracovanie kódu stavu pomocou webového.obsahu vo vlastných konektoroch