– 개념부터 실무 적용까지 깔끔 비교
API 설계 관련 내용을 공부하다 보면
‘REST API’, ‘RESTful API’라는 용어를 자주 접하게 됩니다.
비슷한 말처럼 보이지만, 실제로는 REST와 RESTful은 엄연히 다른 개념입니다.
많은 분들이 REST가 곧 RESTful이라고 생각하지만,
REST는 아키텍처 스타일이고, RESTful은 그 원칙을 얼마나 지켰느냐에 따라 달라지는 설계의 구현 정도입니다.
이번 포스팅에서는 REST와 RESTful의 개념, 차이점, 적용 예시를 정리해드리겠습니다.
✅ REST란 무엇인가요?
REST는 REpresentational State Transfer의 약자로,
웹의 자원을 ‘일정한 규칙’에 따라 접근하고 조작할 수 있도록 만든 아키텍처 스타일입니다.
REST의 주요 원칙:
원칙 설명
| 자원의 명확한 식별 | /users/1 → 사용자 1번 리소스를 의미 |
| 상태 없음 (Stateless) | 요청 간 상태 정보 저장하지 않음 |
| 클라이언트-서버 구조 | 역할이 명확히 분리됨 |
| 계층 구조 지원 | API 중간에 게이트웨이, 프록시 등을 둘 수 있음 |
| 캐시 가능 | 서버 응답은 캐싱이 가능해야 함 |
| 일관된 인터페이스 | HTTP + URI + JSON 조합을 일관되게 사용 |
💡 REST는 ‘방식’이 아닌 ‘철학’ 또는 ‘규칙의 집합’이라고 생각하시면 됩니다.
✅ RESTful이란?
RESTful은 REST의 아키텍처 원칙을 얼마나 충실하게 지켜서 설계했는가를 나타내는 표현입니다.
즉, RESTful API는 “REST 원칙을 지킨 API”라는 의미입니다.
RESTful은 정도의 문제입니다:
구분 의미
| 완전한 RESTful | REST의 6대 원칙을 모두 충실히 따름 |
| 부분 RESTful | HTTP 사용은 하지만 URI 구조, 메서드 매핑이 비일관적임 |
| 비RESTful | SOAP, RPC 등 REST를 따르지 않는 구조 |
✅ REST와 RESTful의 핵심 차이점
항목 REST RESTful
| 정체 | 아키텍처 스타일 | REST를 적용한 API 구현 방식 |
| 대상 | 개념 그 자체 | 실무 설계에서의 실현 정도 |
| 예시 | “REST는 이래야 해” | “이 API는 RESTful하게 설계됐다” |
| 적용 여부 | 이론 중심 | 실제 API 설계 적용 중심 |
👉 요약하자면, REST는 원칙이고 RESTful은 그 원칙을 얼마나 잘 지켰는가입니다.
✅ 예시로 보는 RESTful 설계와 비RESTful 설계
기능 RESTful 예시 비RESTful 예시
| 사용자 조회 | GET /users/1 | GET /getUser?id=1 |
| 사용자 등록 | POST /users | GET /createUser?name=Tom |
| 게시글 삭제 | DELETE /posts/10 | GET /deletePost?id=10 |
비RESTful 방식은 메서드와 URL에 혼동이 생기고, 의미가 명확하지 않으며, 확장성과 일관성이 떨어집니다.
✅ RESTful을 잘 지킨 API의 특징
- URL은 명사형, 메서드는 동사형 역할
- 자원 간 계층 구조 표현: /users/1/comments
- 상태 코드를 명확히 사용: 200 OK, 201 Created, 400 Bad Request 등
- 클라이언트와 서버가 역할을 나누고, 요청은 독립적으로 처리됨
REST는 웹에서 자원을 다루기 위한 설계 철학이고,
RESTful은 그 철학을 얼마나 잘 반영했는지를 나타내는 구현 지표입니다.
RESTful API를 설계하기 위해서는
단순히 HTTP를 쓰는 것이 아니라,
URL 구조, 메서드, 상태 코드, 자원 식별 등 REST 원칙을 제대로 이해하고 적용하는 것이 중요합니다.
💡 REST는 생각, RESTful은 실천입니다.