Web.Contents
Web.Contents(url as text, optional options as nullable record) as binary
Bináris fájlként letöltött tartalmat ad url
vissza. 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 az é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 megváltoztatja a webes kérést a GET-ről a POST-ra, és a beállítás értékét használja a POST tartalmaként.
A HTTP-kérés 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).
A beállítások és Query
a beállítások használatának tartalmának lekérése."https://bing.com/search?q=Power+Query"
RelativePath
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]
]
)
Hozam
binary
Hajtson végre egy POST-t egy URL-címen, adjon át egy bináris JSON hasznos adatokat, é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
Hozam
table
Csatlakozás egy biztonságos URL-címre, amely a lekérdezési sztring részeként elfogad egy hitelesítési kulcsot. 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álják, az alábbi példa létrehoz egy kérést a következőhöz "https://contoso.com/api/customers/get?api_key=******"
: .
Használat
Web.Contents("https://contoso.com/api/customers/get", [ApiKeyName="api_key"])
Hozam
binary
Állapotkód kezelése a Web.Contents használatával egyéni összekötőkben