Utilitários

request

Envia uma solicitação HTTP com opções de método, cabeçalhos, corpo e tempo limite.

Sintaxe

request(options: RequestOptions): Response | string
Aliases http_requesthttp.request

Argumentos

NomeTipoDescrição
optionsRequestOptionsTabela de configurações opcionais que controla como a operação se comporta.

Retornos

NomeTipoDescrição
responseResponse | stringTabela de resposta HTTP ou string de compatibilidade.

Descrição

Envia uma solicitação HTTP com opções de método, cabeçalhos, corpo e tempo limite.

Chame com 1 parametro(s): options. A tabela de argumentos explica quais valores sao obrigatorios e quais refinam o comportamento.

Retorna response (Response | string). Use a tabela de retornos para separar valores bem sucedidos, nil e erros recuperaveis.

Exemplo

Envie uma solicitação JSON e inspecione os campos de resposta pública.

local response = request({
    Url = "https://example.com/api/status",
    Method = "GET",
    Headers = {
        ["Accept"] = "application/json",
    },
})

if type(response) == "table" then
    if response.Success then
        print(response.StatusCode, response.Body)
    else
        warn(response.StatusMessage)
    end
else
    warn(response)
end

Tipos

RequestOptions

Define uma solicitação HTTP.

Url string URL de destino HTTP ou HTTPS.Method? "GET" | "POST" | "PUT" | "PATCH" | "DELETE" Método HTTP usado para a solicitação.Headers? {[string]: string} Cabeçalhos de solicitação adicionais.Cookies? {[string]: string} Cookies adicionados à solicitação de saída.Body? string Corpo da solicitação bruta.