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