RESTful API 란 무엇인가??

REST(REpresentational State Transfer) 정의 :

REST는 웹 서비스가 어떻게 동작해야 하는지에 대한 아키텍처 스타일 또는 설계 원칙입니다. REST는 클라이언트와 서버 간의 상호작용을 규정하며, 여러 가지 원칙과 제약 조건들을 가지고 있습니다. 예를 들어, REST는 상태를 가지지 않는(stateless) 통신, 캐시 가능한 응답 등을 지향합니다.

 

RESTful API 정의 : 

RESTful API는 REST 아키텍처 스타일을 따르는 웹 API이다. 즉, REST 원칙을 잘 지키며 설계된 API를 RESTful API 라고 합니다. 

 

비교

• REST는 이론적인 원칙과 가이드라인 입니다.
• RESTful API는 그 원칙관 가이드라인을 실제로 적용한 API를 의미합니다.

Rest는 일종의 '철학'이고 , RESTful API는 그 '철학'을 실제로 구현한 것 이라고 나는 이해를 했다.

 

 

REST API 설계 시 주의할점

• URI는 명사를 사용하자 : URI는 자원을 나타내는 명사여야 합니다. 동사는 사용하지 않습니다.
• 파일 확장자는 빼자 : 파일 확장자는 URI에 포함하지 않습니다
• 조회 시 쿼리를 활용하자
• URI 마지막 문자로 슬래시(/)를 포함하지 않는다
• URI 경로에는 소문자가 적합하다.