REST API

REST API란?

웹 에서 사용되는 데이터나 리소스를 HTTP URI 로 표현하고,http 프로토콜 을 통한 요청과 응답을 정의하는 하나의 방식이다. Rest api 기반으로 구현한 웹 서비스는 'Restful'하다고 표현한다.

REST API 중심 규칙

1. 웹 에서 사용되는 리소스는 HTTP URI 에다가 표현해야한다

리소스명은 동사가 아닌 명사로 작성해야하고 최대한 리소스 표현을 URI 안에다가 중신적으로 표현해야한다.
리소스명은 getUser 처럼 get 이런 동사를 사용하는걸 자제해야한다.

2. 리소스 대한 행위는 Http Method 를 사용해서 작성한다.

Http Method 는 크게 Post, Get, Delete, put, patch 5가지를 사용해서 CURD 를 구현한다.

REST API 구성요소

1. 리소스 표현
   리소스는 자신만에 고유한 ID인 Http URI 를 가지고있다. 이 자원은 서버에 존재하고 상태를 조작하기 위해 요청을 보낸다.
2. 행위
   http method 를 통해서 리소스 요청 상태를 결정한다.
3. 표현
   클라이언트가 리소스 상태 에 대한 조작을 요청하면 서버는 이에 적절한 응답을 보낸다 리소스는 JSON, XML, TEXT등 여러 형태로 응답으로 나타낸다 현재는 대부분 JSON 형태로 주고 받는다.

REST API 장점

1. REST API 메시지를 읽는것 만으로도 메시지가 의도하는 바를 명확하게 파악이 가능하다 가독성이 좋다.
2. HTTP 인프라 그대로 사용하기 때문에 REST API사용을 위한 별도에 인프라 구축을 요구하지 않는다.
3. stateless 한 특징 때문에 실행컨텍스트가 독립적으로 진행됩으로써 이전에 서버에서 진행된 내용들에 대한 클라이언트 정보를 알 필요가 없으며, 이제까지 진행된 히스토리 대해서도 알 필요가 없게 됩니다. 즉 해당 URI와 원하는 메소드 자체만 독립적으로 이해하면 된다.
4. HTTP 프로토콜 서바스라는 기본적인 요구만 충족되면 다양한 플랫폼에서 원하는 서비스를 쉽고 빠르게 개발하고 배포할 수 있게 된다.
5. REST API는 헤더 부분에 URI 처리 메소드를 명시함으로 서, 필요한 실제 데이터를 페이로드 에 표현할 수 있도록 구성할 수 있는 기능을 제공합닏. 이는 특정 메소드의 세부적인 표현 문구를 JSON,XML 등 다양한 언어를 이용하여 작성할 수 있다 그러면서 간결한 헤더 표현을 통한 가동성 향상이라는 두가지 장점을 얻을 수 있다.

REST API 단점

1. 메소드 형태가 제한적이다.
2. 표준이 존재하지않아 다행한 방식으로 작성이된다.