REST API란?

API (Application Programming Interface)

애플리케이션을 구축하고 통합하기 위한 정의, 프로토콜 세트이다. API를 사용하면 구현방식을 알지 못해도 애플리케이션끼리 서로 커뮤니케이션, 즉 상호작용이 가능하다.

나라는 애플리케이션과 TV라는 애플리케이션이 있다.
서로 상호작용하기 위해서는 리모컨이라는 API를 사용하는 것이다.
나 - 리모컨 - TV

API는 애플리케이션 개발을 간소화하여 개발시간과 비용을 절약해준다.

REST API (Representational State Transfer)

자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 모든 것을 의미한다. 웹에서 데이터를 전송 및 처리하는 방법을 정의한 인터페이스를 말한다.

쉽게 말해,
리소스(HTTP URI로 정의)를 어떻게 하겠다(HTTP Method + CRUD)를 깔끔하게 만들기 위해 구조화 한 것

구성

• 자원(resource): URI
• 행위(verb): HTTP Method
  • HTTP Method를 통해 해당 자원에 대한 CRUD Operation을 적용하여 아래와 같이 사용한다.
    • Create: 데이터 생성 (POST)
    • Read: 데이터 조회 (GET)
    • Update: 데이터 수정 (PUT)
    • Delete: 데이터 삭제 (DELETE)

HTTP URL 를 통해 자원을 명시하고,
HTTP Method(POST, GET, PUT, DELETE) 를 통해
해당 자원의 대한 CRUD 수행

REST API 설계 가이드

• 리소스에 대한 행위는 HTTP Method(POST, GET, PUT, DELETE)로 표현
• 슬래시 구분자(/)는 계층 관계를 나타내는 데 사용
• URI 마지막 문자로 슬래시(/)를 포함하지 않는다.
• 하이픈(-)은 URI 가독성을 높이는데 사용
• 밑줄(_)은 URI에 사용하지 않는다.
• URI 경로에는 소문자가 적합하다.
• 파일 확장자는 URI에 포함시키지 않는다.