Skip to main content

Web.Contents

Pateikiamas turinys, atsisiųstas iš URL kaip dvejatainis.

Syntax​

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

Remarks​

Pateikiamas iš url atsisiųstas turinys kaip dvejetainis. Norint nurodyti papildomas ypatybes, galima pateikti pasirenkamą įrašo parametrą options. Įraše gali būti šie laukai:

  • Query : Programiniu būdu įtraukite užklausos parametrus į URL nesirūpindami dėl kaitos.
  • ApiKeyName : Jei paskirties svetainėje žinomas API raktas, naudojant šį parametrą galima nurodyti URL naudojamo rakto parametro pavadinimą (bet ne reikšmę). Faktinė rakto reikšmė nurodyta kredencialuose.
  • Headers : Nurodžius šią reikšmę kaip įrašą, į HTTP užklausą bus įtraukta papildomų antraščių.
  • Timeout : Nurodant šią reikšmę kaip trukmę bus pakeistas HTTP užklausos skirtasis laikas. Numatytoji reikšmė yra 100 sekundžių.
  • ExcludedFromCacheKey : Nurodant šią reikšmę kaip sąrašą, šie HTTP antraščių raktai nebus įtraukti į duomenų gavimo skaičiavimą.
  • IsRetry : Nurodant šią loginę reikšmę kaip teisingą, bus nepaisoma visų talpykloje esamų atsakymų, kai gaunami duomenys.
  • ManualStatusHandling : Nurodžius šią reikšmę kaip sąrašą, bus neleidžiama vykdyti jokio įtaisytojo HTTP užklausų, kurių atsakas nurodo kurį nors iš šių būsenos kodų, apdorojimo.
  • RelativePath : Nurodžius šią reikšmę kaip tekstą, prieš pateikiant užklausą ji pridedama prie pagrindinio URL.
  • Content : Nurodžius šią reikšmę, žiniatinklio užklausa GET pakeičiama į POST kaip POST turinį naudojant parinkties reikšmę.

HTTP užklausa pateikiama kaip GET (kai nenurodytas turinys) arba POST (kai yra turinys). POST užklausas galima pateikti tik anonimiškai.

HTTP atsakymo antraštės pasiekiamos kaip dvejetainio rezultato metaduomenys. Už pasirinktinės duomenų jungties konteksto ribų galimas tik atsakymo antraščių poaibis (saugumo sumetimais).

Examples​

Example #1​

Gaukite "https://bing.com/search?q=Power+Query" turinį naudodami RelativePath ir užklausos parinktis. Šios parinktys gali būti naudojamos pateikti dinamiškas užklausas statinio pagrindo URL.

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

Result:

binary

Example #2​

Atlikite funkciją SKELBTI pagal URL, perduodami dvejetainio JSON paketo turinį ir analizuodami atsaką kaip 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​

Prisijunkite prie saugaus URL, kuris kaip užklausos eilutės dalį priima autentifikavimo raktą. Užuot užprogramavus slaptąjį raktą M (tai gali kelti grėsmę saugai), raktą galima saugiai pateikti nurodant jo pavadinimą (ne jo reikšmę) M, pasirinkdami žiniatinklio API autentifikavimą ir įvesdami rakto reikšmę kaip žiniatinklio API kredencialų dalį. Naudojant tokiu būdu, toliau pateiktame pavyzdyje bus sugeneruota užklausa "https://contoso.com/api/customers/get?api_key=**"".

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

Result:

binary

Category​

Accessing data