REST API 란

REST API란 웹 기반의 아키텍처 스타일 중 하나로 클라이언트와 서버간의 통신을 위한 인터페이스를 제공한다. REST API는 HTTP와 같은 기존 웹 프로토콜을 기반으로 하며, 자원을 표현하는 URI와 HTTP메서드를 이용하여 서버에 접근하고 조작할 수 있게 해준다.

1. URI 와 HTTP의 메서드

REST API는 크게 두가지로 나눌 수 있다.

1. URI(URL)

   목적어, 어떤 자원에 접근할 것인지에 대한 것
   (API주소와 주소에 대한 엔드포인트)

2. 메서드

   리소스 조회 : Query Parameter
   GET : 리소스 가져오기 - 멱등성, 캐싱 가능

   리소스 변경 : Query Parameter + Request Body
   POST : 리소스 생성
   PUT : 리소스 전체 업데이트
   PATCH : 리소스 부분 업데이트
   DELETE : 리소스 삭제

이 두가지 원칙을 잘 지켰다면 'REST ful'하다라고 표현한다.

'REST ful' 하다면 이 두가지의 표현만 보고 해당 API가 무슨 역할을 하는지 쉽게 알 수 있다.