네트워크 - REST API란?

안녕하세요.

고코더 입니다. 

 

 

REST API는 REST를 이용한 API를 구성한 방식입니다. 

REST API

Representational State Transfer Application Programming Interface
(대표 상태 전송, 애플리케이션 프로그래밍 인터페이스)
  

 REST API란? REST 기반의 서비스를 API로 구현한 서비스를 말합니다.  즉 REST 아키텍처의 제약 조건을 준수하는 애플리케이션 프로그래밍 인터페이스를 말합니다. HTTP 프로토콜로 실행되는 네트워크 기반 아키텍처입니다. 

 

 

특징

 REST 기반으로 시스템을 구성하면 확장성 그리고 재사용성을 높일 수 있습니다. 그리고 개발 담당자를 분리하여 운용을 좀 더 편리하게 이어갈 수 있습니다. 그리고 HTTP 기반으로 구현하므로, 프로그램 언어의 선택의 폭이 넓고, 하나의 언어로 클라이언트와 동일한 언어를 사용할 수 있습니다. 즉 백엔드와 프런트를 나누어 전문성 있는 개발자가 담당 부분만 개발할 수 있는 분업을 이룰 수 있습니다.

 

 

REST API 규칙

 

1. URI는 소문자를 사용한다. 

- 대문자를 피하고, 소문자를 사용합니다. 

http://gocoder.net/api

 

2. 슬래시("/)는 계층 관계를 표현한다.

- 윈도우에서 폴더를 나타내는 것처럼 슬래시는 계층을 표현합니다.

http://gocoder.net/api/board/1

 

3. 언더바(_)는 피하고, 하이픈(-)을 사용한다.

- 밑줄은 가독성이 취약합니다. 하이픈을 사용합니다.

http://gocoder.net/api/board/1/hello-api

 

4. 로직을 나타내는 행위를 표현하지 않는다.

- 예를 들면 해당 API가 수정이라면 update를 넣지 않습니다. 

http://gocoder.net/api/board/1/hello-api/post/hello

 

* 참조 자료

Allocation ReSTful Web Service Implementation