Utilities

request

Sendet eine HTTP-Anfrage mit Methoden-, Header-, Text- und Timeout-Optionen.

Syntax

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

Argumente

NameTypBeschreibung
optionsRequestOptionsOptionale Einstellungstabelle, die das Verhalten des Vorgangs steuert.

Rückgaben

NameTypBeschreibung
responseResponse | stringHTTP-Antworttabelle oder Kompatibilitätszeichenfolge.

Beschreibung

Sendet eine HTTP-Anfrage mit Methoden-, Header-, Text- und Timeout-Optionen.

Rufe es mit 1 Parameter(n) auf: options. Die Argumenttabelle erklärt, welche Werte erforderlich sind und welche nur das Verhalten verfeinern.

Es gibt response (Response | string) zurück. Nutze die Rückgabetabelle, um erfolgreiche Werte von nil-Ergebnissen und behandelbaren Fehlern zu trennen.

Beispiel

Senden Sie eine JSON-Anfrage und überprüfen Sie die öffentlichen Antwortfelder.

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

Typen

RequestOptions

Definiert eine HTTP-Anfrage.

Url string HTTP- oder HTTPS-Ziel-URL.Method? "GET" | "POST" | "PUT" | "PATCH" | "DELETE" Für die Anfrage verwendete HTTP-Methode.Headers? {[string]: string} Zusätzliche Anforderungsheader.Cookies? {[string]: string} Der ausgehenden Anfrage hinzugefügte Cookies.Body? string Roher Anfragetext.