跳到主要内容

Request()

一个用于执行互联网网络请求的模块,于 1.0.0.31 版本引入。

构造函数

Request(url: string)

参数

参数类型说明
urlstring网站地址,可以是 https 或 http

方法

setHeader(key: string, value: string): Request

为 HTTP 请求设置自定义请求头。

参数

参数类型说明
keystring请求头名称
valuestring请求头的值

返回值

Request - 返回 Request 对象,以便进行方法链式调用

setParameter(key: string, value: string): Request

为请求体设置参数(与 POST/PUT 请求配合使用)。

参数

参数类型说明
keystring参数名称
valuestring参数的值

返回值

Request - 返回 Request 对象,以便进行方法链式调用

get(): Response

执行 GET 请求并返回一个 Response 对象。

返回值

Response - 包含服务器响应的响应对象

post(): Response

执行 POST 请求并返回一个 Response 对象。

返回值

Response - 包含服务器响应的响应对象

put(): Response

执行 PUT 请求并返回一个 Response 对象。

返回值

Response - 包含服务器响应的响应对象

delete(): Response

执行 DELETE 请求并返回一个 Response 对象。

返回值

Response - 包含服务器响应的响应对象

示例

基本 GET 请求

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

带请求头和参数的 POST 请求

local response = Request("https://api.example.com/users")
:setHeader("Content-Type", "application/json")
:setHeader("Authorization", "Bearer token123")
:setParameter("name", "John Doe")
:setParameter("email", "john@example.com")
:post()

链式调用多个方法

-- Request 对象支持方法链式调用,提供流畅的 API
local response = Request("https://api.example.com/data")
:setHeader("API-Key", "your-api-key")
:setParameter("query", "search term")
:setParameter("limit", "10")
:get()