Megosztás a következőn keresztül:


Web.Contents

Szintaxis

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

Rólunk

Visszaadja a url-ról bináris formában letöltött tartalmat. További tulajdonságok megadásához megadható egy opcionális rekordparaméter (options). A rekord a következő mezőket tartalmazhatja:

  • Query: Programozott módon adjon hozzá lekérdezési paramétereket az URL-címhez anélkül, hogy a meneküléssel kellene foglalkoznia.
  • ApiKeyName: Ha a célhelyen van egy API-kulcs fogalma, ez a paraméter az URL-ben használandó kulcsparaméter nevét (nem értékét) adhatja meg. A tényleges kulcsértéket a hitelesítő adatok adják meg.
  • Headers: Ha rekordként adja meg ezt az értéket, további fejléceket fog megadni egy HTTP-kéréshez.
  • Timeout: Ha ezt az értéket időtartamként adja meg, az megváltoztatja a HTTP-kérések időtúllépését. Az alapértelmezett érték 100 másodperc.
  • ExcludedFromCacheKey: Ha ezt az értéket listaként adja meg, az kizárja, hogy ezek a HTTP-fejléckulcsok az adatok gyorsítótárazási számításának részei legyenek.
  • IsRetry: Ha ezt a logikai értéket igaz értékként adja meg, az adatok beolvasásakor figyelmen kívül hagyja a gyorsítótárban lévő összes meglévő választ.
  • ManualStatusHandling: Ha ezt az értéket listaként adja meg, az megakadályozza azoknak a HTTP-kéréseknek a beépített kezelését, amelyek válasza az alábbi állapotkódok egyikével rendelkezik.
  • RelativePath: Ha ezt az értéket szövegként adja meg, a kérés előtt hozzáfűzi az alap URL-címhez.
  • Content: Ennek az értéknek a megadása a webes kérést GET-ről POST-ra módosítja, és a beállítás értékét használja a POST tartalmaként.

Az HTTP-kérés vagy GET (ha nincs megadva tartalom), vagy POST (ha van tartalom). A POST-kérések csak névtelenül adhatók meg.

A HTTP-válasz fejlécei metaadatokként érhetők el a bináris eredményen. Az egyéni adatösszekötő-környezeten kívül csak a válaszfejlécek egy részhalmaza érhető el (biztonsági okokból).

1. példa

A "https://bing.com/search?q=Power+Query" tartalmának lekérése a RelativePath és Query beállításokkal. Ezekkel a beállításokkal dinamikusan kérdezhetők le statikus alap URL-címek.

használat

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

kimeneti

binary

2. példa

Hajtson végre egy POST műveletet egy URL-címen, adjon át egy bináris JSON terhet, és elemezze a választ JSON-ként.

Használat

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

kimeneti

table

3. példa

Csatlakozzon egy biztonságos URL-címhez, amely elfogadja a hitelesítési kulcsot a lekérdezési sztring részeként. A titkos kulcs M-ben történő kemény kódolása helyett (amely biztonsági kockázatot jelentene), a kulcs biztonságosan biztosítható a neve (nem az értéke) megadásával az M-ben, a webes API-hitelesítés kiválasztásával, valamint a kulcs értékének a webes API-hitelesítő adatok részeként történő beírásával. Ha így használja, az alábbi például egy kérést generál a "https://contoso.com/api/customers/get?api_key=******"címhez.

Használat

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

kimenet

binary

További információ

Állapotkódok kezelése Web.Contents egyéni csatlakozókban