01. REST의 개념

• 2000년 로이 필딩(Roy Fielding)이 박사학위 청구 논문에서 REST(Representational State Transfer)를 소프트웨어 아키텍처 스타일로 제안

• REST : Representational State Transfer
  • 자원(resource)의 표현(representation) 에 의한 상태(State) 전달
    • 자원: 문서, 그림, 데이터, 소프트웨어 자체 등
    • 표현: 그자원을 표한하기 위한 이름 예) 영화=movies
    • 상태: 자원의 상태를 전달
      • PUT: 자원이 업데이트된 상태
      • POST: 자원이 새로 추가된 상태
      • GET: 자원을 읽은 상태
      • DELETE: 자원이 삭제된 상태

...

• Method	URI	Description
  GET	/movies	Get list of movies
  GET	/movies/:id	Find ad movie by its ID
  POST	/movies	Create a new movie
  PUT	/movies/:id	Update an existing movie
  DELETE	/movies/:id	Delete an existing movie

02. REST이전

• 단점
  • 개발자마다 API설계가 다르다.
  • CRUD를 만들기 위해 API를 여러개 만들어야 한다.

...

• REST기반으로 서비스 API를 구현한것
• REST API의 특징
  1. Server-Client구조
  2. Stateless(무상태)
     
     • 세션이나 쿠키등을 별도로 관리하지 않습니다.
     • 클라이언트의 컨텍스트를 서버쪽에 유지하지 않습니다.
  3. Cacheable(캐시 처리 가능)
     • HTTP가 가진 캐싱 기능이 적용 됩니다.
     • HTTP 프로토콜 표준에서 사용하는 Last-Modified태그나 E-Tag를 이용하면 캐싱 구현이 가능하다.
  4. Self-descriptiveness (자체 표현 구조)
     • REST 구조만 보아도 쉽게이해할 수 있는 자체 표현 구조를 가지고 있습니다.
  5. Layered System(계층화)
     • 클라이언트 입장에서는 REST Api서버만 호출한다. 
     • Rest server를 다중 계층으로 구성
       • 보안, LB, 암호화, 인증등의 계층을 추가.
  6. Uniform Interface(인터페이스 일관성)
     • URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행한다.

• Info
  1~5특징은 이미 HTTP프로토콜에 포함된 개념 입니다.

• 장점
  • API디자인에서 발생할 수 있는 문제를 최소화 한다.
  • 서버와 클라이언트 역할을 명확하게 분리한다.
  • API가 의도하는 바를 쉽게 파악할 수 있다.
  • HTTP표준 프로토콜에 따르는 모든 플랫폼에서 사용 가능하다.
• 단점
  • 표준이 존재하지 않는다.
  • 사용할 수 있는 메소드가 4가지 밖에 없다.

• Method	OLD API	RES API	Data
  C	POST /users/addUser.co	POST /users	{'id':'sansae', 'email':'sooabia@sansae.net'}
  R	GET /users/getUser.do?id=sansae	GET /users/:id
  U	POST /users/modUser.do?id=sansae	PUT /users/:id	{'id':'sansae', 'email':'sooabia@sansae.net'}
  D	GET /users/delUser.

...

• do?id=sansae

  DELETE /users/:id

• 버전관리
  • http://domain.com/api/v1.0/users

...