🧩 RESTful API 제대로 알기: 개념부터 예제까지 한방에 정리!

RESTful API는 웹 개발자라면 반드시 알아야 할 핵심 기술입니다.

---

✅ REST란 무엇인가요?

**REST(Representational State Transfer)**는 2000년에 로이 필딩(Roy Fielding)이 논문에서 처음 제안한 아키텍처 스타일입니다.
쉽게 말해, 웹에서 자원을 HTTP 방식으로 다루는 표준화된 방법이라고 생각하시면 됩니다.

---

📌 REST의 6가지 핵심 제약조건

제약 조건설명

1. 클라이언트-서버 구조	역할을 분리하여 유지보수성과 확장성 향상
2. 무상태(Stateless)	요청 간 서버는 클라이언트 상태를 저장하지 않음
3. 캐시 처리 가능	응답 데이터는 캐싱될 수 있어야 함
4. 계층화 시스템	중간 서버를 통해 확장 구조 구성 가능
5. 인터페이스 일관성	URI, HTTP 메서드 등 통일된 사용법 준수
6. 코드 온 디맨드 (선택사항)	서버가 클라이언트에 스크립트 전송 가능

 

---

🧭 RESTful API란?

REST 원칙을 따르는 API를 말합니다. 즉, HTTP 메서드와 URL을 이용해 자원을 CRUD 방식으로 처리하는 것이죠.

---

🚀 RESTful API 예제

가상의 블로그 게시글(Post)에 대한 API를 설계한다고 가정해볼게요.

기능HTTP 메서드URI설명

목록 조회	GET	/posts	모든 게시글 조회
단일 조회	GET	/posts/{id}	특정 게시글 조회
작성	POST	/posts	게시글 작성
수정	PUT	/posts/{id}	게시글 전체 수정
삭제	DELETE	/posts/{id}	게시글 삭제

 

---

🔄 RESTful 하지 않은 API 예시

GET /getPosts
POST /createPost

• ❌ 이런 방식은 RESTful하지 않습니다.
• ✅ RESTful 방식은 명사 중심 URI와 HTTP 메서드를 적절히 사용하는 것이 핵심입니다.

---

💡 RESTful API 설계 시 팁

• URI에는 동사 대신 명사 사용
• URI는 소문자 사용
• 언더스코어(_)보단 하이픈(-) 사용 권장
• 응답 상태 코드 (200, 201, 400, 404 등) 정확히 설정
• 예외 응답은 JSON 형태로 일관되게 처리

---

🛠️ RESTful API 구현 프레임워크

• Spring Boot (Java)
• Express (Node.js)
• Flask / Django REST Framework (Python)
• FastAPI (Python, 최신 트렌드)
• Laravel (PHP)