HTTP/네트워크

REST API란?
웹에서 사용되는 데이터나 자원(Resource)을 HTTP URI로 표현하고, HTTP 프로토콜을 통해 요청과 응답을 정의하는 방식

REST 성숙도 모델

0단계:HTTP 사용

HTTP 프로토콜을 사용하는 것. 단,해당 API를 REST API라고 할 수는 없다. 0단계는 REST API를 작성하기 위한 기본 단계

1단계:개별 리소스와의 통신 준수

REST API는 웹에서 사용되는 모든 데이터나 자원(Resource)을 HTTP URI로 표현하기 때문에 모든 자원은 개별 리소스에 맞는 엔드포인트(Endpoint)를 사용해야하며 요청하고 받는 자원에 대한 정보를 응답으로 전달해야 한다

2단계: HTTP 모델 원칙 준수

CRUD(Create(생성), Read(조회), Update, Delete)에 맞게 적절한 HTTP 메서드를 사용. 거기에더해
GET(서버의 데이터를 변화시키지 않는 요청),
POST(교체, 요청마다 새로운 리소스를 생성)
PUT(요청마다 같은 리소스를 반환하는 멱등성을 가짐),
PATCH(수정),
를 구분해 사용해야 함.

3단계:HATEOAS(Hypermedia As The Engine Of Application State)원칙 준수

응답에는 리소스의 URI를 포함한 링크 요소를 삽입.
실제로 3단계까지 지키기 어렵기 때문에 2단계까지만 적용해도 좋은 API 디자인이라고 볼 수 있고, 이런 경우를 HTTP API 라고도 부른다