REST API.

* REST ( Representational State Transfer ) - Mage By Roy.Fielding

 

# Rest 란 

- 네트워크 아키텍쳐의 원리 모음. 

- web의  입장에서는 사이트의 구성 원리 정도로 이해 .

 

# Rest 아키텍쳐의 6가지 제한 조건 

- 클라이언트 / 서버 구조 

- 무상태 ( Stateless )

- 캐시 처리 가능 ( Cacheable )

- 계층화 ( Layered System )

- Code on demand ( optional ) :  ex )java script 

- 인터페이스 일관성 

 

# Rest Api 구조에 대해서 

- REST API 에 맞게 구현이 되어 있느냐는 많은 논란을 주는 부분입니다.

   REST 의 개념을 정리한 Roy.Fieiding 은 보다 엄격한 기준을 제시한다.

   ( Self descriptive Message  및 Hypermedia 관련 (HATEOAS ) 등 )

- 일반적으로( 가볍운 개념정도 )는 HTTP API 에 이미 Rest 원칙이 들어 있으며,

   인터페이스 일관성 정도에 신경쓰면 될것이다.

 

# 인터페이스 일관성 유지 

- URL 주소만 보고도 수행 하려는 동작을 눈치 챌 수 있게 만드는 것

 

# respful api 예시 

- url의 의미중 명사가 리소스 , 동사가 메소드로 만듭니다.

메소드	리소스	ID	의미
GET	/posts		글 목록을 봅니다
POST	/posts		글을 생성합니다.
PUT	/posts	/{id}	글을 수정 합니다.
DELETE	/posts	/{id}	글을 삭제 합니다.

 

# 메소드 사용 방법 

메소드	수행하기 전,후	반복 수행한 결과	리소스의 수
GET	같다	같다	같다
POST	다르다	다르다	많아진다
PUT	다르다	같다	같다
DELETE	다르다	다르다	적어진다

 

# 올바른 Restful

메소드	uri	O/X
PUT	/dogs/1/isSick	X	id와 리소스 이외의 정보를 uri에 담으면 안된다
PUT	/dogs/1?isSick=true	O
POST	/login	X	리소스에는 명사가 와야 한다.
POST	/users/login	X	리소스에는 명사가 와야 한다.
POST	/session	O

 

 

# 정리 참고 

- www.youtube.com/watch?v=ETdbm5jDDsg

- www.youtube.com/watch?v=RP_f5dMoHFc