본문으로 건너뛰기
API 도구 기초집LESSON 02

HTTP 요청·응답 구조와 상태 코드

난이도입문 → 초급
예상 시간30분
선수지식이전 강의

2강. HTTP 요청·응답 구조와 상태 코드

1. 이번 강의에서 해결할 문제​

게임 기록·랭킹 API를 테스트하면서 HTTP 메시지의 메서드·경로·헤더·본문과 상태 코드 계열을 읽습니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

요청은 메서드, URL, 헤더, 선택적 본문으로 구성되고 응답은 상태 코드, 헤더, 본문으로 구성됩니다. 2xx는 성공, 4xx는 요청 또는 인증 문제, 5xx는 서버 처리 실패를 뜻합니다. 숫자 하나만 보지 말고 오류 JSON의 detail 같은 필드도 함께 확인해야 원인을 좁힐 수 있습니다.

4. 단계별 실습​

실습 경로: C:\dev\game-ranking-api-tests

  1. 정상 상태 엔드포인트의 응답 헤더까지 저장합니다.
  2. 없는 경로로 404를 의도적으로 만듭니다.
  3. 성공과 실패의 상태·본문을 표로 비교합니다.
PowerShell
$baseUrl = "http://127.0.0.1:8000"
Invoke-WebRequest -Method Get -Uri "$baseUrl/health" | Select-Object StatusCode, Headers, Content
try { Invoke-RestMethod -Uri "$baseUrl/not-found" } catch { $_.Exception.Response.StatusCode.value__ }

Postman의 버튼·탭 이름은 버전에 따라 달라질 수 있습니다. 메뉴가 다르면 설치된 앱의 도움말과 Postman 공식 문서를 먼저 확인합니다.

5. 요청과 응답이 동작하는 이유​

서버는 라우팅 성공 여부와 처리 결과를 상태 코드로 요약합니다. 헤더는 표현 형식과 캐시 같은 메타데이터를 전달하고, JSON 본문은 실제 결과나 오류 세부 정보를 전달합니다.

6. 자주 하는 실수와 해결법​

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

HTTP 요청·응답 구조와 상태 코드 미니 퀴즈

선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.

0 / 2
  1. 문제 1“HTTP 요청·응답 구조와 상태 코드” 코드 리뷰에서 유지해야 할 설계 원칙은 무엇인가요?
  2. 문제 2‘모든 실패를 서버 장애로 봄’ 실수를 판단할 때 “HTTP 요청·응답 구조와 상태 코드” 강의가 제시한 기준은 무엇인가요?

답을 선택하면 진행 결과가 자동으로 저장됩니다.

LESSON STATUS

학습을 마쳤나요?

직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.

2강. HTTP 요청·응답 구조와 상태 코드 미완료 상태