-
REST 한 방식으로 설계된 API 를 말한다.
그럼 REST 란 무엇일까.
유저는 URL을 통해서 요청을 보낸다.
그리고 해당 요청을 보낼때 HTTP Method를 사용한다.
근데 서버에서 아무렇게나 맘대로 컨트롤러를 뚫어 놓고 유저랑 소통하는게 아닌,
특정 규칙과 원칙을 따라서 설계를 하자는게 퍼지게 되었으며
그 지침을 제공하는게 REST 형식이다.
그럼 RESTful API란 무엇인가
RESTful 은 REST 형식을 지켜서 설계된 웹 서비스 API 이다.
그럼 RESTful API 인지 확인하기 위해 REST의 특징은 뭐가 있는지 보자.
1. Server-Client
2. Stateless
3. Cacheable
4. Layered System
5. Uniform Interface
6. On-Demand Code
7. Self-descriptiveness
위의 것들이 REST의 특징인데 이것들을 만족하기 위한 디자인 가이드가 있다.
- URI는 동사보다 명사를 사용한다.
- 자원에 대한 행위는 HTTP Method로 표현한다.
- 슬래시로 계층 관계를 표현한다.
- URI 마지막에는 슬래시를 붙이지 않는다.
- URI는 소문자로만 구성한다.
- 가독성이 떨어지는 경우 하이픈을 사용한다.
RESTful API 설계시에 다음을 꼭 기억하면 된다.
URI는 정보의 자원을 표현하고 자원에 대한 행위는 HTTP Method로 표현한다