Share via


WebAction.Request

Sintaxe

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

Sobre

Cria uma ação que, quando executada, retornará os resultados de realizar uma solicitação method com relação a url usando HTTP como um valor binário. Um parâmetro de registro opcional, options, pode ser fornecido para especificar propriedades adicionais. O registro pode conter os seguintes campos:

  • Query: adicione programaticamente parâmetros de consulta à URL sem precisar se preocupar com a saída.
  • ApiKeyName: se o site de destino tiver uma noção de uma chave de API, esse parâmetro poderá ser usado para especificar o nome (não o valor) do parâmetro de chave que deve ser usado na URL. O valor real da chave é fornecido na credencial.
  • Headers: especificar esse valor como um registro fornecerá cabeçalhos adicionais a uma solicitação HTTP.
  • Timeout: especificar esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor padrão é de 100 segundos.
  • ExcludedFromCacheKey: especificar esse valor como uma lista excluirá essas chaves de cabeçalho HTTP de fazerem parte do cálculo para armazenar dados em cache.
  • IsRetry: a especificação desse valor lógico como verdadeiro ignorará qualquer resposta existente no cache ao buscar dados.
  • ManualStatusHandling: especificar esse valor como uma lista impedirá qualquer manipulação interna para solicitações HTTP cuja resposta tenha um desses códigos de status.
  • RelativePath: especificar esse valor como texto o acrescentará à URL base antes de fazer a solicitação.
  • Content: especificar esse valor fará com que o conteúdo se torne o corpo da solicitação HTTP.

Observe que essa função está desabilitada na maioria dos contextos. Em vez disso, considere usar Web.Content ou Web.Headers.

Exemplo 1

Execute uma solicitação GET no Bing.

Usage

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

Saída

Action