Rest API

Updated: July 21, 2021

Goal

REST의 개념을 이해한다.

REST의 특징을 이해한다.

REST API의 개념을 이해한다.

REST API의 설계 규칙을 이해한다.

RESTful의 개념을 이해한다.

HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고, HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미
CRUD Operation
- Create : 생성(POST)
- Read : 조회(GET)
- Update : 수정(PUT)
- Delete : 삭제(DELETE)
- HEAD : haeder 정보 조회(HEAD)

장점
- HTTP 프로트콜의 인프라를 그대로 사용 -> REST API 사용을 위한 별도의 인프라를 구축할 필요 없음..
- HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용 가능
- Hypermedia API의 기본을 충실히 지키면서 범용성을 보장
- REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있음
단점
- 표준이 존재하지 않는다
- 사용할 수 있는 메소드가 4가지 밖에 없다

자원(Resource) : URI
- 모든 자원을 고유한 ID가 존재하고, 이 자원은 Server에 존재한다
- 자원을 구별하는 ID는 ‘/groups/:group_id’와 같은 HTTP URI이다
- Client는 URI를 이용해 자원을 지정하고 해당 자원의 상태에 대한 조작을 Server에 요청한다
행위(Verb) : HTTP Method
- HTTP 프로토콜의 Method를 사용한다
- HTTP 프로토콜을 GET, POST, PUT, DELETE와 같은 메서드를 제공한다
표현(Representation of Resource)
- Clinet가 자원의 상태에 대한 조작을 요청하면 Server는 이에 적절한 응답을 보낸다
- REST에서 하나의 자원은 JSON, XML, TEXT, RSS 등 여러 형태의 Representation으로 나타내어 질 수 있다
- JSON 혹은 XML를 통해 데이터를 주고 받는 것이 일반적이다

API(Application Programming Interface)란
- 데이터와 기능의 집합을 제공하여 컴퓨터 프로그램간 상호작용을 촉진하며, 서로 정보를 교환 가능 하도록 하는 것
REST API의 정의
- REST 기반으로 서비스 API를 구현한 것
- 최근 OpenAPI(누구나 사용 가능한 API : 구글 맵, 공공 데이터 등), 마이크로 서비스(하나의 큰 애플리케이션을 여러 개의 작은 애플리케이션으로 쪼개어 변경과 조합이 가능하도록 만든 아키텍처) 등을 제공하는 업체 대부분은 REST API를 제공한다