본문으로 건너뛰기

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("요청 성공!")
    print("응답 데이터: " .. data)
else
    print("요청 실패, 상태: " .. 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 요청은 멱등성을 가집니다. 즉, 동일한 요청을 여러 번 보내도 동일한 효과를 냅니다.