REST API란? (+상세 설명 까지)

🔶 REST API란?

REST는 REpresentational State Transfer의 약자이고,
REST API는 이 REST 원칙을 따르는 웹 API를 의미해요.

🔹 REST의 핵심 개념

📌 자원(Resource)

• 서버에 존재하는 데이터나 기능
• 예: 게시글, 사용자, 상품 등

📌 자원에 접근하는 방법: URL (엔드포인트)

GET /users          → 모든 사용자 목록
GET /users/1        → ID가 1인 사용자 정보
POST /users         → 사용자 생성
PUT /users/1        → ID 1번 사용자 정보 수정
DELETE /users/1     → ID 1번 사용자 삭제

📌 행위(동작): HTTP 메서드

• GET: 데이터 조회
• POST: 데이터 생성
• PUT 또는 PATCH: 데이터 수정
• DELETE: 데이터 삭제

🔹 REST API는 이런 특징을 가짐

원칙	설명
클라이언트-서버 구조	프론트(React 등)와 백엔드(Spring, Node 등)가 분리되어 독립적으로 동작
무상태성(Stateless)	서버는 요청을 처리할 때 이전 요청 상태를 기억하지 않음 (요청마다 모든 정보 포함)
자원 기반	URL은 자원을 표현 (예: /posts, /users)
일관된 인터페이스	같은 방식으로 자원에 접근하고 조작 (HTTP 메서드 기반)

🧩 REST API 쉽게 이해하기 (예시 중심 설명)

🎯 예시 상황: "블로그 시스템"

사용자는 블로그 글을 보고, 작성하고, 수정하고, 삭제할 수 있음. 이걸 기반으로 REST의 특징을 설명해볼게요.

1. ✅ 자원(Resource) 기반 구조

REST에서는 URL이 자원을 나타내고, 동작은 HTTP 메서드로 구분합니다.

동작	REST URL	설명
전체 글 조회	GET /posts	글 목록 가져오기
특정 글 조회	GET /posts/7	ID 7번 글 보기
글 작성	POST /posts	새 글 작성
글 수정	PUT /posts/7	ID 7번 글 수정
글 삭제	DELETE /posts/7	ID 7번 글 삭제

2. ✅ 무상태성 (Stateless)

서버는 클라이언트의 상태를 저장하지 않습니다. 매 요청마다 인증 정보 등을 모두 포함시켜야 해요.

GET /posts/7
Authorization: Bearer abc.def.ghi

3. ✅ 일관된 인터페이스

자원마다 CRUD 방식이 동일합니다. 예측하기 쉽고 문서화도 편합니다.

동작	HTTP	URL 예시
조회	GET	/posts, /users, /comments
생성	POST	/posts, /users
수정	PUT	/posts/1, /users/3
삭제	DELETE	/posts/2

4. ✅ 클라이언트-서버 분리

React는 UI만 처리하고, 서버는 JSON 데이터만 응답합니다.

axios.get('https://api.myblog.com/posts/7')
  .then(res => setPost(res.data));

{
  "id": 7,
  "title": "REST API가 뭐지?",
  "content": "쉽게 설명해드릴게요!"
}

5. ✅ 캐시 처리

클라이언트는 서버의 응답을 캐싱할 수 있어야 합니다. 자주 변경되지 않는 블로그 목록 같은 데이터를 캐시하면 서버 부하를 줄일 수 있습니다.

Cache-Control: max-age=3600

6. ✅ 계층 구조

API 요청은 보안, 캐시, 로깅 등을 담당하는 여러 계층을 거칠 수 있어요.

예: React 앱 → Nginx(SSL 처리) → API 서버 → DB

7. ✅ Code on Demand (선택사항)

서버는 필요시 클라이언트에게 자바스크립트나 HTML 조각 등 실행 가능한 코드를 전달할 수 있어야 합니다. (자주 사용되진 않음)

서버 응답: <script>alert("공지사항을 확인하세요!");</script>

🔚 정리

특징	예시 기반 설명
자원 기반	/posts, /users, /comments 같은 명사 URL
무상태성	요청마다 인증 정보 등 상태 포함
일관된 인터페이스	CRUD 규칙이 자원마다 동일
인터페이스 일관성	표준화된 URI와 메서드로 API 일관성 유지
클라이언트-서버 분리	React는 UI, 서버는 JSON 응답
캐시 가능	블로그 목록 등 응답을 캐시해 재사용
계층 구조	중간 프록시, 인증, 캐시 계층 가능
Code on Demand	서버가 실행 가능한 JS 코드 전달 가능 (옵션)