Documentación de Real

Utilidades

request

Envía una solicitud HTTP con opciones de método, encabezados, cuerpo y tiempo de espera.

Sintaxis

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

Argumentos

NombreTipoDescripción
optionsRequestOptionsTabla de configuración opcional que controla cómo se comporta la operación.

Retornos

NombreTipoDescripción
responseResponse | stringTabla de respuestas HTTP o cadena de compatibilidad.

Descripción

Envía una solicitud HTTP con opciones de método, encabezados, cuerpo y tiempo de espera.

Llamalo con 1 parametro(s): options. La tabla de argumentos explica que valores son obligatorios y cuales refinan el comportamiento.

Devuelve response (Response | string). Usa la tabla de retornos para separar valores correctos, resultados nil y errores recuperables.

Ejemplo

Envíe una solicitud JSON e inspeccione los campos de respuesta 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 una solicitud HTTP.

Url string URL de destino HTTP o HTTPS.Method? "GET" | "POST" | "PUT" | "PATCH" | "DELETE" Método HTTP utilizado para la solicitud.Headers? {[string]: string} Encabezados de solicitud adicionales.Cookies? {[string]: string} Cookies agregadas a la solicitud saliente.Body? string Cuerpo de solicitud sin formato.