REST API (RESTfull API)가 뭘까?

onady·2022년 4월 18일

REST API란?

REST는 Representational State Transfer라는 용어의 약자로 웹의 장점을 최대한 활용할 수 있도록 만들어진 네트워크 아키텍처 원리의 모음이다. 여기서 '네트워크 아키텍처 원리'란 자원을 정의하고 자원에 대한 주소를 지정하는 방법 전반을 일컫는다.
즉 REST란
1. HTTP URI를 통해 자원을 명시하고
2. HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD를 적용하는 것을 의미합니다.

CRUD란 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인 Create, Read, Update, Delete를 묶어서 일컫는 말로 REST에서 CRUD는 다음과 같다

Create : 데이터 생성(POST)

Read : 데이터 조회(GET)

Update : 데이터 수정(PUT)

Delete : 데이터 삭제(DELETE)

REST는 아래에서 설명할 제약조건(특징)들을 가지고 있는데 이 모든 제약조건이 지켜진 형태를 REST “-ful” 하다고 표현한다.

REST 아키텍처에 적용되는 6가지 제약 조건

1. Uniform Interface

간단하고 잘 파악할 수 있도록 하기 위해 일관적인 인터페이스로 분리되어야 한다
4가지 제약조건
- Identification Of Resources
  - 리소스는 유일하게 식별되어야 하기 때문에 URI와 HTTP Method를 이용해 동작을 구분한다.
- Manipulation of Resources through Representation
  - HTTP Method를 이용해 동작을 표현한다.
- Self - Descriptive Messages
  - Request/Response 메세지 스스로가 어떤 동작을 하는지 설명이 되어야한다.
  - Request 메세지는 HTTP Method를 이용해 어떤 동작을 하는지 설명이 가능하다.
  - Response 메세지는 HTTP Status Code, Header를 이용해 응답에서 어떤 상태이고, 어떤 응답을 했는지 설명이 가능하다.
- Hypermedia As The Engine Of Application State (HATEOAS)
  - 하이퍼링크를 이용해서 애플리케이션 상태를 전이 하는것을 의미한다.
  - 리소스 Request에 대한 Response에 다음 Action에 대한 URI를 함께 리턴해줌으로써 요청 URI가 변경되었을 시에 클라이언트가 코드를 고치지 않고, 서버에서 동적으로 생성한 URI를 사용하여 클라이언트 코드를 변경하지 않도록 해줄 수 있다.
```
200 OK 
{
    "id" : "1", 
    "name" : "zayson", 
    "links" : {
        "grade" : "/members/1/grade",     // 등급을 수정하는 ACTION URI 전달
        "exp" : "/members/1/exp"          // 경험치를 수정하는 ACITON URI 전달
    }
}
```