REST란?

REST (Representational State Transfer)는
웹의 자원을 HTTP URI로 표현하고, HTTP 메서드(GET, POST 등)를 통해 자원에 행위를 수행하는 아키텍처 스타일!

요약 :
"자원을 URI로 표현하고, 행위는 HTTP 메서드로 구분하는 것!"

RESTful이란?

REST 아키텍처 스타일을 따르는 웹 API를 RESTful API라고 합니다!
즉, URL 설계와 메서드 사용 방식이 REST 원칙을 잘 지키고 있으면
"Chill RESTful하다"고 말합니다.

REST의 구성 요소

• 자원(Resource) - URI (예: /users/1)

• 행위(Verb) - HTTP 메서드 (GET, POST, PUT, DELETE 등)

• 표현(Representation) - JSON, XML 등으로 자원의 상태를 표현

RESTful API 설계 원칙

URI를 명사, 리소스를 나타내기

옳은 예: /users, /products/123
틀린 예: /getUser, /updateProduct

HTTP 메서드를 행위로 구분하기

메서드	의미	사용 예시
GET	자원 조회	GET /users/1
POST	자원 생성	POST /users
PUT	자원 전체 수정	PUT /users/1
PATCH	자원 일부 수정	PATCH /users/1
DELETE	자원 삭제	DELETE /users/1

계층적 구조를 갖도록 URI를 설계하기

예 : /users/1/posts/3 : 사용자 1의 글 3번

상태를 서버에 저장하지 않기 (Stateless).

서버는 요청 간의 상태를 기억하지 않고, 매 요청에 필요한 정보를 포함해야 합니다.

RESTful API의 장점

• 명확한 구조로 이해하기 쉬움
• 표준 HTTP 방식 활용 → 다양한 클라이언트에서 사용 가능
• 캐싱, 계층화, 유연한 확장성 지원

---

API를 RESTful 하게 구성하여 알아보기 편하게 만들어 보자!