跳到主要内容

Request():get()

执行 GET 请求并返回一个 Response 对象。此方法用于从指定的 URL 获取数据。

签名

get(): Response

返回值

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

描述

get() 方法向创建 Request 对象时指定的 URL 发送 HTTP GET 请求。GET 请求通常用于从服务器获取数据,而不会修改任何现有数据。

示例

基本 GET 请求

--API 端点发起 GET 请求
local response = Request("https://api.example.com/users"):get()

带自定义请求头的 GET 请求

-- 带身份认证请求头的 GET 请求
local response = Request("https://api.example.com/protected-data")
:setHeader("Authorization", "Bearer your-token-here")
:setHeader("Accept", "application/json")
:get()

处理 GET 响应

-- 发起请求并处理响应
local response = Request("https://jsonplaceholder.typicode.com/posts/1"):get()

-- 以字符串形式获取响应数据
local data = response:getData()

-- 获取 HTTP 状态码
local statusCode = response:getResponseCode()

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

带查询参数的 GET 请求

-- 对于带查询参数的 GET 请求,请将其包含在 URL
local response = Request("https://api.example.com/search?q=lua&limit=10"):get()
local results = response:getData()

说明

  • GET 请求不应包含请求体。如果需要发送数据,请改用 POST()
  • 该方法返回一个 Response 对象,您可以通过它访问响应数据和状态码
  • 请始终检查响应状态码,以确保请求成功
  • GET 请求是幂等的,即多次发起相同的请求应产生相同的效果