🌐 웹 개발 필수 지식! HTTP와 REST API 개념 정리

웹 개발을 시작하면서 가장 먼저 이해해야 할 개념 중 하나는 바로 HTTP와 REST API입니다.
처음 접하면 헷갈릴 수 있지만, 이 글을 통해 기초부터 확실히 정리해봅시다!

---

📡 HTTP란?

HTTP (Hypertext Transfer Protocol) 는
웹에서 클라이언트(브라우저)와 서버가 데이터를 주고받을 때 사용하는 통신 규칙(프로토콜)입니다.

쉽게 말해, 웹 브라우저가 서버에 "이거 주세요!" 하고 요청(Request)을 보내면,
서버가 "여기 있어요!" 하고 응답(Response)해주는 구조입니다.

📌 특징

• Stateless(상태 없음): 각 요청은 독립적으로 처리됩니다.
  👉 이전 요청 정보를 기억하지 않습니다.
• 기본 포트: 80번
• 전송 방식: 주로 TCP/IP 위에서 작동

---

🌍 URL이란?

URL (Uniform Resource Locator) 은 인터넷 상의 자원의 주소입니다.

예:

https://www.example.com/user/1

URL 설계에 원칙이 있다.

• 명사 사용: URL은 자원을 나타내는 명사로 구성된다. 예를 들어, 영화 데이터를 다룰 경우 movies와 같이 사용한다. 동사를 사용하지 않는다.
• 계층 구조: 자원의 계층을 명확하게 표현한다. 예를 들어, 모든 영화는 api/v1/movies로 특정 ID를 가진 영화는 /api/v1/movies/ 뒤에 ID를 붙여 구분한다.
• 버전 관리: API 버전을 URL에 포함하여 관리한다. (예: /api/**v1**/movies). 이는 향후 API 변경 시 호환성을 유지하는 데 도움이 된다.
• HTTP 메서드 활용: 각 HTTP 메서드는 자원에 대한 특정 작업을 의미하며, 이를 통해 API 호출의 의도를 명확히 한다.

• GET: 자원을 조회할 때 사용
  • GET /api/v1/movies: 모든 영화 목록을 가져옵니다.
  • GET /api/v1/movies/{id}: 특정 ID의 영화를 가져옵니다.

• POST: 새로운 자원을 생성할 때 사용합니다.
  • POST /api/v1/movies: 새로운 영화를 생성합니다.
• PUT: 기존 자원을 전체 업데이트할 때 사용합니다.
• DELETE: 자원을 삭제할 때 사용합니다.
• 데이터 형식: API 간 데이터 교환을 위해 JSON 형식을 사용합니다.

---

🔁 REST API란?

REST (Representational State Transfer) 는
HTTP 프로토콜을 기반으로 자원을 CRUD(Create, Read, Update, Delete) 방식으로 처리할 수 있도록 설계한 아키텍처 스타일입니다.

자원 중심 사고(Resource-centric thinking): REST API 설계의 핵심은 "무엇"을 다룰 것인지, 즉 자원(Resource)에 집중하는 것이다. 동사보다는 명사를 사용하여 자원을 나타내고, 이 자원에 대한 CRUD의 작업을 HTTP 메서드를 통해 수행한다.

REST의 구성 요소

• 자원(Resource): URL로 표현 → /user/1
• 행위(Method): HTTP 메서드 사용 → GET, POST, PUT, DELETE

👉 이런 REST 원칙을 잘 지켜서 만든 API를 RESTful API라고 부릅니다.

---

⚙️ HTTP 메서드 정리

메서드	용도	예시
GET	자원 조회	GET /user/1
POST	자원 생성	POST /user Body: { "name": "John" }
PUT	자원 수정(전체 덮어쓰기)	PUT /user/1 Body: { "name": "Jane" }
DELETE	자원 삭제	DELETE /user/1

---

📊 HTTP 상태 코드 (Status Code)

서버는 응답할 때 결과 상태를 숫자로 알려줍니다. 이게 바로 HTTP 상태 코드입니다.

코드 범위	의미
1xx	정보 (처리 중)
2xx	성공 (요청 처리 완료)
3xx	리다이렉션 (다른 위치로 이동 필요)
4xx	클라이언트 오류 (잘못된 요청)
5xx	서버 오류 (서버 처리 실패)

자주 보는 상태 코드

• 200 OK: 정상 처리
• 201 Created: 자원 생성 성공
• 400 Bad Request: 잘못된 요청
• 401 Unauthorized: 인증 필요
• 404 Not Found: 해당 자원 없음
• 500 Internal Server Error: 서버 내부 에러

---

💬 마무리

👇 추천 강의
니꼬 선생님의 5분 REST API 설계 강의

---

✍️ "한 번쯤 웹 서버 개발을 해봤지만, 기초는 제대로 몰랐던 것 같다…"
이런 분들을 위해 정리해봤습니다. 이 글이 도움이 되셨다면 공유도 부탁드려요 😊