REST API

CH_Hwang·2021년 12월 7일

CS REST API restful api 레스트풀API

CS

목록 보기

2/10

REST API란?

REST 아키텍처의 제약 조건을 준수하는 Application Programming Interface(API)
이때, REST는 Representational State Tranfer의 줄임말.

자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것.

REST란

HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고,
HTTP Method(POST, GET, PUT, DELETE)를 통해
해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미

REST 구성 요소

자원(Resource): HTTP URI
자원에 대한 행위(Verb): HTTP Method
자원에 대한 행위의 내용 (Representations): HTTP Message Pay Load

REST의 특징

Server-Client(서버-클라이언트 구조)
- REST API 디자인에서 클라이언트와 서버 애플리케이션은 서로 간에 완전히 독립적이어야함.
  클라이언트 애플리케이션이 알아야 하는 유일한 정보는 요청된 리소스의 URI이며, 이는 다른 방법으로 서버 애플리케이션과 상호작용 할 수 없음.
  이와 유사하게 서버 애플리케이션은 HTTP를 통해 요청된 데이터에 전달하는 것 말고는 클라이언트 애플리케이션을 수정하지 않아야 함
Stateless(무상태)
- 각 요청에서 이의 처리에 필요한 모든 정보를 포함해야 함
  서버측 세션을 필요로 하지 않으며 서버 애플리케이션은 클라이언트 요청과 관련된 데이터를 저장할 수 없음
Cacheable(캐시 처리 가능)
- 리소스를 클라이언트 또는 서버측에서 캐싱할 수 있어야함
  또한 서버 응답에 전단된 리소스에 대해 캐싱이 허용되는지 여부에 대한 정보도 포함되어야 함.
  서버측의 확장성 증가와 함께 클라이언트 측의 성능 향상을 동시에 얻는 것
Layerd System(계층화)
- REST API에서는 호출과 응답이 서로 다른 계층을 통과함. 일반적으로 클라이언트와 서버 애플리케이션이 서로 간에 직접 연결되지 않으며 통신루프에는 다수의 서로 다른 중개자가 있을 수 있음.
  REST API는 엔드 애플리케이션 또는 중개자와 통신하는지 여부를 클라이언트나 서버가 알 수 없도록 설계되어야함.
Uniform Interface(인터페이스 일관성)
- 요청이 어디에서 오는지와 무관하게 동일한 리소스에 대한 모든 API 요청은 동일하게 보여야 함.
  REST API 는 사용자의 이름이나 이메일 주소 등의 동일ㄹ한 데이터 조각이 오직 하나의 URI에 속함을 보장해야함. 리소스가 너무 클 필요는 없지만, 이는 클라이언트가 필요로 하는 모든 정보를 포함해야함
Code Ondemand(옵션)
- 일반적으로 정적 리소스를 전송하지만 특정한 경우 응답에 실행코드를 포함할 수 있음. 이 경우, 코드는 요청 시에만 실행되어야 함