RestAPI 란

흔히 우리가 rest api라고 부르는것은 Http API인 경우가 많다고 한다. restAPI라고 부르기 위해서 따라야하는 제약조건이 무엇인지 Naver d2 강의를 보며 정리해 보았다.

RestAPI란

-  Rest 아키텍처에 따르는 API

* 아키텍처: 제약조건의 집합. 제약조건을 모두 따라야 아키텍처이다. 그렇다면 Rest API의 제약조건은 무엇일까

Rest를 구성하는 스타일

- clinet-server

- stateless

- cache

- uniform Interface

- layered System

- code-on-demand

-> 대부분 잘 지켜지지만 uniform interface는 잘 지켜지지 않는다.

Uniform Interface

• identification of resources
  • 리소스는 URI로 식별되어야한다.
• manipulation of resources throug representations:
  • representation으로 리소스를 조작해야한다. http 메시지를 통해 uri에 update, delete, insert로 전달한다는 의미
• self-descriptive message: 메시지는 스스로 설명해야한다. 
  • 메시지만을 보고 메시지의 내용을 온전히 해석 가능해야한다. 아래 사진처럼 메시지의 op, path등을 content-type을 보고 json-path, json로 이루어진 것이다를 알야야함

 

• hypermedia as th engin of application state(HATEOAS)
  • 애플리케이션의 상태는 Hyperlink를 이용해 전이되어야한다.
  • 링크를 통해 다른 페이지로 이동해야한다.

 

왜 uniform interface를 만족해야하는가?

독립적인 진화 때문  -> 서버와 클라이언트는 독립적으로 진화한다. 서버의 기능이 변경되어도 클라이언트를 업데이트할 필요가 없다. 

 

출처) https://www.youtube.com/watch?v=RP_f5dMoHFc&t=834s