API, REST API, RESTful API에 대해서

들어가기

 REST API 정의, 특징, 장점과 단점, 사용 규칙에 대해서 알아보자. REST API를 설명하기 앞서 API에 대해서 먼저 알아본다.

 

API

 API는 Application Programming Interface의 축약형으로 애플리케이션에서 사용할 수 있도록 운영 체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스를 말한다.

\ 클라이언트의 요청을 서버에 전달하고, 서버의 결과물을 클라이언트에게 돌려주는 역할을 한다.

 

REST, REST API, RESTful API

 REST는 Representational State Transfer의 축약형으로 자원을 이름으로 구분해 자원의 상태를 주고받는 것을 말한다. REST의 특징으로는 인터페이스 일관성, 무상태, 캐시 처리 가능, 계층화, 클라이언트/서버 구조, Code on demand(선택사항)이 있다.

 REST API는 REST의 특징을 이용한 API로 URL의 설계 방식을 말한다. 장점으로는 URL만으로 어떤 행동을 하는 API인지 명확하게 알 수 있고, 무상태이므로 클라이언트와 서버의 역할이 명확하게 분리된다.

 RESTful API는 REST하게 디자인한 API를 말한다. 

 

사용 규칙

1. URL에는 동사를 쓰지 말고, 자원을 표시한다.
   /articles/1 : 올바른 사용
   /articles/show/1 : 올바르지 않은 사용. 'show'라는 동사 사용.
2. 동사는 HTTP 메서드로 사용한다.
   HTTP 메서드 : GET, POST, PUT, PATCH, DELETE 등
   GET /articles/1
   POST /articles
   PUT /articles/1
   DELETE /articles/1
3. 슬래시(/)는 계층 관계를 나타내는 데 사용한다.
4. 언더바(_) 대신에 하이픈(-)을 사용한다.
5. URL에는 소문자 영단어만 사용한다.