Restful

---

🌿 Restful이란?

정의

Restful은 REST의 제약 조건과 설계 원칙을 잘 따르도록 API를 구성한 스타일을 말한다. 리소스를 명확하게 표현하고 HTTP Method의 의미를 잘 살리는 것이 핵심이다.

🧩 구성 요소

구성 요소	설명
Resource	URI로 표현되는 자원
Method	HTTP Method
Representation	JSON, XML 같은 표현 형식

📌 RESTful의 핵심 원칙

• 명사형 URI를 사용한다.
• 행위는 HTTP Method로 표현한다.
• 리소스를 중심으로 설계한다.
• 상태 정보를 과도하게 URI에 넣지 않는다.
• 표현 형식은 일관되게 유지한다.

포인트

RESTful은 URI에 동사를 넣지 않고, 메서드로 동작을 표현하는 방식과 잘 맞는다.

✅ 좋은 예

GET /users
GET /users/1
POST /users
PUT /users/1
DELETE /users/1

❌ 피해야 할 예

GET /getUser
POST /createUser
POST /deleteUser

🔄 RESTful과 REST API 설계

• RESTful은 설계 스타일 자체를 말한다.
• REST API 설계는 그 스타일을 실제 API 규칙으로 구체화한 것이다.
• 둘은 거의 함께 언급되지만, RESTful이 더 개념적이다.

정리

RESTful은 REST 원칙을 잘 지킨 API 스타일이고, REST API 설계는 그 원칙을 실제 프로젝트에서 적용하는 방법이다.

⚠️ 주의할 점

• 모든 API가 완벽한 RESTful일 필요는 없다.
• 실무에서는 가독성, 보안, 유지보수성을 함께 고려해야 한다.
• REST 원칙보다 팀 규칙이 더 중요한 경우도 있다.

🧾 정리

Restful은 리소스 중심의 HTTP API 스타일이다. 명확한 URI와 HTTP Method 사용이 핵심이며, 설계 규칙이 일관될수록 이해와 유지보수가 쉬워진다.

---

연결문서

• REST API 설계
• HTTP Method
• HTTP