Condividi tramite


WebAction.Request

Sintassi

WebAction.Request(method as text, url as text, optional options as nullable record) as action

Informazioni su

Crea un'azione che, quando eseguita, restituisce i risultati dell'esecuzione di una richiesta method su url usando HTTP come valore binario. È possibile fornire un parametro di record facoltativo, options, per specificare proprietà aggiuntive. Il record può contenere i campi seguenti:

  • Query: aggiungere parametri di query a livello di codice all'URL senza doversi preoccupare dell'escape.
  • ApiKeyName: se il sito di destinazione riconosce una chiave API, questo parametro può essere usato per specificare il nome, non il valore, del parametro chiave che deve essere usato nell'URL. Il valore di chiave effettivo viene specificato nella credenziale.
  • Headers: se si specifica questo valore come record, verranno fornite intestazioni aggiuntive a una richiesta HTTP.
  • Timeout: se si specifica questo valore come durata, verrà modificato il timeout per una richiesta HTTP. Il valore predefinito è 100 secondi.
  • ExcludedFromCacheKey: se si specifica questo valore come elenco, le chiavi di intestazione HTTP verranno escluse dal calcolo per la memorizzazione dei dati nella cache.
  • IsRetry: se si specifica questo valore logico come true, durante il recupero dei dati verrà ignorata qualsiasi risposta esistente nella cache.
  • ManualStatusHandling: se si specifica questo valore come elenco, si eviterà la gestione predefinita per le richieste HTTP la cui risposta presenta uno di questi codici di stato.
  • RelativePath: se si specifica questo valore come testo, questo viene aggiunto all'URL di base prima di effettuare la richiesta.
  • Content: se si specifica questo valore, il relativo contenuto diventerà il corpo della richiesta HTTP.

Nota: questa funzione è disabilitata nella maggior parte dei contesti. Invece è consigliabile usare Web.Contents o Web.Headers.

Esempio 1

Eseguire una richiesta GET su Bing.

Utilizzo

WebAction.Request(WebMethod.Get, "https://bing.com")

Output

Action