RESTful API

RESTful API : REST(Representational State Transfer) 아키텍처 스타일을 기반으로 하는 API

==> "좋은 API 만드는 법"

 

REST의 구성

- 자원(URL)

- 행위(Http Method) : GET, POST, PUT, DELETE

- 표현 : 서버가 응답할때 JSON, XML, TEXT, RSS등 여러 형태의 응답

 

REST 아키텍처 스타일의 원칙들

1. Uniform Interface 

- 여러 URL과 method는 일관성이 있어야합니다.

- 하나의 URL로는 하나의 데이터를 가져오게 디자인하는게 좋고 

- 간결하고 예측가능하게 URL과 method를 만드는게 좋습니다. 

 

2. Client-server 역할 구분 

유저에게 서버역할을 맡기거나 DB를 직접 입출력하게 시키면 안좋습니다. 

 

3. Stateless (무상태성)

요청들은 서로 의존성이 있으면 안되고 각각 독립적으로 처리되어야합니다.

 

4. Cacheable (캐시 처리 가능)

서버가 보내는 자료들은 캐싱이 가능해야합니다.

그러니까 자주 받는 자료들은 브라우저에서 하드에 저장해놓고 

서버에 요청을 날리는게 아니라 하드에서 뽑아쓰는걸 캐싱이라고 합니다. 

 

5. Layered System (계층화)

서버기능을 만들 때 레이어를 걸쳐서 코드가 실행되도록 만들어도 된다고 합니다. 

 

6. Code on demand

서버는 실행가능한 코드를 보낼 수 있습니다.

웹 사이트에서 등록 양식을 작성하면 브라우저는 잘못된 전화번호와 같은 실수를 즉시 강조 표시합니다.

서버에서 전송한 코드로 인해 이 작업을 수행할 수 있습니다.