Response:getResponseCode()

Ruft den HTTP-Statuscode aus der Antwort ab.

Signatur

getResponseCode(): number

Rückgabe

number - Der HTTP-Statuscode (z. B. 200, 404, 500)

Beschreibung

Die Methode getResponseCode() gibt den HTTP-Statuscode aus der Serverantwort zurück. Statuscodes geben an, ob die HTTP-Anfrage erfolgreich war, fehlgeschlagen ist oder weitere Schritte erforderlich sind.

Beispiele

Einfache Statuscode-Prüfung

-- Make a request and check the status code
local response = Request("https://api.example.com/users"):get()
local statusCode = response:getResponseCode()

if statusCode == 200 then
    print("Request successful!")
    local data = response:getData()
    print("Response data: " .. data)
else
    print("Request failed with status: " .. statusCode)
end

Umfassende Statuscode-Behandlung

local response = Request("https://api.example.com/data"):get()
local status = response:getResponseCode()

if status >= 200 and status < 300 then
    -- Success responses (2xx)
    print("Request successful (2xx)")
    local data = response:getData()
    print("Data: " .. data)

elseif status >= 300 and status < 400 then
    -- Redirection responses (3xx)
    print("Redirection received (3xx)")
    print("Status: " .. status)

elseif status >= 400 and status < 500 then
    -- Client error responses (4xx)
    print("Client error (4xx)")
    local errorData = response:getData()
    if errorData and errorData ~= "" then
        print("Error details: " .. errorData)
    end

elseif status >= 500 and status < 600 then
    -- Server error responses (5xx)
    print("Server error (5xx)")
    local errorData = response:getData()
    if errorData and errorData ~= "" then
        print("Server error details: " .. errorData)
    end

else
    print("Unexpected status code: " .. status)
end

Behandlung spezifischer Statuscodes

local response = Request("https://api.example.com/users/123"):get()
local status = response:getResponseCode()

if status == 200 then
    print("OK - Request successful")
    local userData = response:getData()
    print("User data: " .. userData)

elseif status == 201 then
    print("Created - Resource created successfully")
    local newResource = response:getData()
    print("New resource: " .. newResource)

elseif status == 204 then
    print("No Content - Request successful, no response body")

elseif status == 400 then
    print("Bad Request - Invalid request data")
    local errorInfo = response:getData()
    print("Error: " .. errorInfo)

elseif status == 401 then
    print("Unauthorized - Authentication required")

elseif status == 403 then
    print("Forbidden - Access denied")

elseif status == 404 then
    print("Not Found - Resource does not exist")

elseif status == 500 then
    print("Internal Server Error")
    local serverError = response:getData()
    print("Server error details: " .. serverError)

else
    print("Other status: " .. status)
    local otherData = response:getData()
    if otherData and otherData ~= "" then
        print("Response: " .. otherData)
    end
end

HTTP-methodenspezifische Statuscodes

-- GET request
local getResponse = Request("https://api.example.com/data"):get()
local getStatus = getResponse:getResponseCode()

if getStatus == 200 then
    print("Data retrieved successfully")
elseif getStatus == 404 then
    print("Data not found")
end

-- POST request
local postResponse = Request("https://api.example.com/users")
    :setParameter("name", "John")
    :setParameter("email", "john@example.com")
    :post()

local postStatus = postResponse:getResponseCode()

if postStatus == 201 then
    print("User created successfully")
    local newUser = postResponse:getData()
    print("Created user: " .. newUser)
elseif postStatus == 400 then
    print("Invalid user data")
elseif postStatus == 409 then
    print("User already exists")
end

-- DELETE request
local deleteResponse = Request("https://api.example.com/users/123"):delete()
local deleteStatus = deleteResponse:getResponseCode()

if deleteStatus == 204 then
    print("User deleted successfully")
elseif deleteStatus == 404 then
    print("User not found")
end

Hilfsfunktion für Statuscodes

function handleResponse(response)
    local status = response:getResponseCode()
    local data = response:getData()

    -- Success (2xx)
    if status >= 200 and status < 300 then
        print("✓ Request successful (" .. status .. ")")
        if data and data ~= "" then
            return data
        else
            return "Success (no content)"
        end
    end

    -- Client errors (4xx)
    if status >= 400 and status < 500 then
        print("✗ Client error (" .. status .. ")")
        if data and data ~= "" then
            print("Error details: " .. data)
        end
        return nil
    end

    -- Server errors (5xx)
    if status >= 500 and status < 600 then
        print("✗ Server error (" .. status .. ")")
        if data and data ~= "" then
            print("Server error: " .. data)
        end
        return nil
    end

    print("? Unexpected status: " .. status)
    return nil
end

-- Usage
local response = Request("https://api.example.com/data"):get()
local result = handleResponse(response)

if result then
    print("Operation successful: " .. result)
else
    print("Operation failed")
end

API-Wiederholungslogik

function makeRequestWithRetry(url, maxRetries)
    local retries = 0

    while retries < maxRetries do
        local response = Request(url):get()
        local status = response:getResponseCode()

        -- Success
        if status == 200 then
            return response:getData()
        end

        -- Don't retry on client errors (4xx)
        if status >= 400 and status < 500 then
            print("Client error (" .. status .. "), not retrying")
            return nil
        end

        -- Retry on server errors (5xx)
        if status >= 500 and status < 600 then
            retries = retries + 1
            print("Server error (" .. status .. "), retrying... (" .. retries .. "/" .. maxRetries .. ")")
            -- Wait before retrying (you might want to add a delay here)
        else
            retries = retries + 1
            print("Unexpected status (" .. status .. "), retrying... (" .. retries .. "/" .. maxRetries .. ")")
        end
    end

    print("Max retries reached, giving up")
    return nil
end

local data = makeRequestWithRetry("https://api.example.com/unstable", 3)
if data then
    print("Request succeeded: " .. data)
end

Häufige HTTP-Statuscodes

Code	Category	Meaning	Typical Usage
200	Erfolg	OK	Anfrage erfolgreich
201	Erfolg	Created	Ressource erstellt
204	Erfolg	No Content	Erfolg, kein Antwortkörper
400	Client-Fehler	Bad Request	Ungültige Anfragedaten
401	Client-Fehler	Unauthorized	Authentifizierung erforderlich
403	Client-Fehler	Forbidden	Zugriff verweigert
404	Client-Fehler	Not Found	Ressource existiert nicht
409	Client-Fehler	Conflict	Ressourcenkonflikt
500	Server-Fehler	Internal Server Error	Serverseitiger Fehler
502	Server-Fehler	Bad Gateway	Ungültige Upstream-Antwort
503	Server-Fehler	Service Unavailable	Server vorübergehend nicht verfügbar

Hinweise

Prüfen Sie immer den Statuscode, bevor Sie die Antwortdaten verarbeiten
Statuscodes sind über HTTP/1.1 und HTTP/2 hinweg standardisiert
2xx-Codes zeigen Erfolg an, 3xx zeigen Umleitung, 4xx zeigen Client-Fehler, 5xx zeigen Server-Fehler
Einige APIs verwenden möglicherweise benutzerdefinierte Statuscodes oder nicht standardmäßige Bedeutungen
Fehlerantworten (4xx, 5xx) können nützliche Informationen im Antwortkörper enthalten
Netzwerkfehler oder Timeouts können die Erstellung eines Response-Objekts vollständig verhindern

Signatur​

Beschreibung​

Beispiele​

Einfache Statuscode-Prüfung​

Umfassende Statuscode-Behandlung​

Behandlung spezifischer Statuscodes​

HTTP-methodenspezifische Statuscodes​

Hilfsfunktion für Statuscodes​

API-Wiederholungslogik​

Häufige HTTP-Statuscodes​

Hinweise​