• Studio

  • Studio API

  • Bots

  • Web API

  • Designer Resources

  • Host Resources

  • Globals

    HTTPClient

    Methods

    Request

    ServerOnly

    Sends an HTTP request and invokes the callback with the response. Requests are rate-limited; bursts of requests may fail with HTTPError.RequestThrottled.

    local request = HTTPRequest.new("https://api.example.com/scores", HTTPMethod.POST)
    request:SetHeader("Content-Type", "application/json")
    request:SetJSONBody({ user_id = player.user.id, score = 100 })
    
    HTTPClient.Request(request, function(response, error)
        if error ~= HTTPError.None or response == nil then
            print("Request failed: " .. tostring(HTTPError[error]))
            return
        end
        if response:GetStatusCode() ~= 200 then
            print("HTTP " .. response:GetStatusCode() .. ": " .. tostring(response:GetBody()))
            return
        end
        local data = response:GetJSONBody() -- decoded into a Lua table
        print("New rank: " .. data.rank)
    end)
    

    Parameters

    callback
    (response: HTTPResponse, error: HTTPError) -> ()

    Returns

    void
    PocketWorlds Icon

    © 2026 Pocket Worlds. All rights reserved.