[네트워크] REST API란?(2) 장단점, Restful

1️⃣ REST  장점

👉 HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라 구축이 필요 없다. 

👉 HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있게 해준다.

👉 HTTP 프로토콜을 따르는 모든 플랫폼에서 사용 가능하다.

👉 REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있다.

👉 서버와 클라이언트의 역할을 명확하게 분리한다.

 

2️⃣ REST 단점

👉 표준이 자체가 존재하지 않아 정의가 필요하다.

👉 HTTP Method 형태가 제한적이다.

👉 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야 하므로 전문성이 요구된다. 

 

3️⃣ REST  설계 예시

1. URI는 동사보다 명사를, 대문자보다는 소문자를 사용하여야 한다. 

나쁜 예시 http://hobin49.com/Playing/
좋은 예시 http://hobin49.com/play/

 

2. 마지막에 슬래시(/)를 포함하지 않는다.

나쁜 예시 http://hobin49.com/test/
좋은 예시 http://hobin49.com/test

 

3. 언더바 대신 하이폰을 사용한다. 

나쁜 예시 http://hobin49.com/test_blog
좋은 예시 http://hobin49.com/test-blog

 

4. 파일확장자는 URI에 포함하지 않는다.

나쁜 예시 http://hobin49.com/photo.jpg
좋은 예시 http://hobin49.com/photo

 

5.행위를 포함하지 않는다.

나쁜 예시 http://hobin49.com/delete-post/1
좋은 예시 http://hobin49.com/post/1

 

4️⃣ RESTful이란?

👉 RESTful이란 Rest의 원리를 따르는 시스템을 의미한다.  

👉 REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful 하다 말할 수 있다.

👉 모든 CRUD 기능을 POST로 처리하는 API 혹은 URI규칙을 올바르게 지키지 않은 API는 REST API 설계 규칙을 올바르게 지키지 못한 시스템은 REST API를 사용하였지만 RESTful 하지 못한 시스템이라고 할 수 있다.