Request()
一个用于执行互联网网络请求的模块,于 1.0.0.31 版本引入。
构造函数
Request(url: string)
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| url | string | 网站地址,可以是 https 或 http |
方法
setHeader(key: string, value: string): Request
为 HTTP 请求设置自定义请求头。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| key | string | 请求头名称 |
| value | string | 请求头的值 |
返回值
Request - 返回 Request 对象,以便进行方法链式调用
setParameter(key: string, value: string): Request
为请求体设置参数(与 POST/PUT 请求配合使用)。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| key | string | 参数名称 |
| value | string | 参数的值 |
返回值
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()