지금까지 API 연동을 하면서 연동하는 과정만 익혔지 REST의 역할이 무엇인지 왜 사용하는지?에 대한 근본적인 이유가 없었습니다. 그래서 REST에 관해서 자세하게 공부하려합니다.
REST?
“Repersentational State Transfer” 의 약자로
자원을 이름으로 구분하여 자원의 상태(정보)를 주고 받는 모든 것을 의미
즉 REST란
- HTTP URL을 통해 자원을 명시하고
- HTTP Method(POST, GET, PUT, DELETE)를 통해
- 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미합니다.
CRUD Operation
CRUD는 기본적인 데이터 처리 기능인 Create, Read, Update, Delete를 말합니다.
CRUD Operation 동작으로는
- Create : POST
- Read : GET
- Update : PUT
- Delete : DELETE
REST가 필요한 이유
‘애플리케이션 분리 및 통합’ , ‘다양한 클라이언트의 등장’
REST 구성 요소
- 자원 : HTTP URI
- 자원에 대한 행위 : HTTP Method (GET, POST, PUT, DELETE)
- 자원에 대한 행위의 내용 : HTTP Message Pay Load
REST의 장단점
장점
- HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구출할 필요가 없다.
- HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있게 해 준다.
- HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능하다.
- REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있다.
- 여러 가지 서비스 디자인에서 생길 수 있는 문제를 최소화한다.
- 서버와 클라이언트의 역할을 명확하게 분리한다.
단점
- 표준이 자체가 존재하지 않아 정의가 필요하다.
- 사용할 수 있는 메소드가 4가지밖에 없다.
- HTTP Method 형태가 제한적이다.
- 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야 하므로 전문성이 요구된다.
- 구형 브라우저에서 호환이 되지 않아 지원해주지 못하는 동작이 많다.(익스폴로어)
REST API?
REST의 원리를 따른 API를 의미합니다
REST API를 설계하기 위해서는 몇가지 규칙이 있습니다.
- URI는 동사보다 명사, 대문자 보다는 소문자를 사용해야 한다.
Bad Example http://silverbeen.com/Running
Good Example http://silverbeen.com/run- 마지막에 슬래시를 포함하지 않는다.
Bad Example http://silverbeen.com/test/
Good Example http://silverbeen.com/test- 언더바 대신 하이폰을 사용한다.
Bad Example http://silverbeen.com/test_blog
Good Example http://silverbeen.com/test-blog- 행위를 포함하지 않는다.
Bad Example http://silverbeen.com/delete-post/1
Good Example http://silverbeen.com/post/1REST API를 만들어보자
RESTful 은 또 뭐야?
REST의 원리를 따르는 시스템을 의미합니다.
하지만, REST를 사용했다고 모두가 RESTful 한 것은 아닙니다.
REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful 하다고 합니다!
RESTful 하지 못한 경우
Ex1) CRUD 기능을 모두 POST로만 처리하는 API
Ex2) route에 resource, id 외의 정보가 들어가는 경우(/students/updateName)
