API와 REST API

식당 비유 - 주문 이후 손님에게 전달될 때까지 상황 생각해보기 

: 식당에 가면 손님 -> 점원 -> 주방 이렇게 주문이 전달되고, 나올 때는 주방 -> 점원 -> 손님 순으로 전달된다. 

 

그림으로 정리하면 다음과 같다.

식당으로 알아보는 API

 

API는 클라이언트의 요청을 서버에 잘 전달하고,

서버의 결과물을 클라이언트에게 잘 돌려주는 역할을 한다.

 

# REST API

REST

REST는 Representational State Transfer

풀어서 말하면 자원을 이름으로 구분해 자원의 상태를 주고받는 API 방식.

 

# REST API 의 특징 / 장단점

1. 특징

- 서버/클라이언트 구조，무상태，캐시 처리 가능，계층화，인터페이스 일관성 

 

2. 장단점

장점

- REST API의 장점은 URL만 보고도 무슨 행동을 하는 API인지 명확하게 알 수 있다.
- 상태가 없다는 특징이 있어서 클라이언트와 서버의 역할이 명확하게 분리.

- HTTP 표준을 사용하는 모든 플랫폼에서 사용할 수 있죠.

 

단점

- HTTP 메서드 개수에 제한이 있고，

- 설계를 하기 위해 공식적으로 제공되는 표준 규약이 없다

 

그럼에도 REST API는 주소와 메서드만 보고 요청의 내용을 파악할 수 있다는 강력한 장점이 있어 많은 개발자들이 사용 중.

 

 

# 사용법

규칙 1. URL 에는 동사를 쓰지 말고，자원을 표시해야 한다

뭐가 더 맞는가?

- RESTful API는 1번이다. 왜냐하면 2번의 경우 자원이 아닌 다른 표현을 섞어 사용했기 때문.

 

 

규칙 2. 동사는 HTTP 메서드로

* 슬래시는 계층 관계를 나타내는데 사용하거나, 밑줄 대신 하이픈을 사용하거나, 자원의 종류가 컬렉션인지 도큐먼트인지에 따라 단수, 복수를 나누거나 하는 등의 규칙이 있다.