REST API

API

프로그램 간에 상호작용하기 위한 매개체

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

 

REST API

웹의 장점을 최대한 활용하는 API

자원을 이름으로 구분해 자원의 상태를 주고받는 API

REST API는 URL의 설계 방식

 

REST API의 특징

서버/클라이언트 구조

무상태

캐시 처리 가능

계층화

인터페이스 일관성

 

REST API 장점

URL만 보고도 무슨 행동을 하는 API인지 명확하게 알 수 있다

상태가 없다는 특징이 있어서 클라이언트와 서버의 역할이 명확하게 분리된다

 

REST API 단점

HTTP 메서드, 즉 GET, POST와 같은 방식의 개수에 제한이 있고 설계를 하기 위해 공식적으로 제공되는 표준 규약이 없다

=> 그럼에도 주소와 메서드만 보고 요청의 내용을 파악할 수 있어서 REST API를 사용한다

---

 

REST API 사용법

 

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

/articles/1	적합	동사 없음, 1번 글을 가져온다는 의미가 명확
/articles/show/1 /show/articles/1	부적합	show라는 동사 존재

 

2. 동사는 HTTP 메서드로

HTTP 메서드는 POST, GET, PUT, DELETE

id가 1인 블로그 글을 조회하는 API	GET/articles/1
블로그 글을 추가하는 API	POST/articles/1
블로그 글을 수정하는 API	PUT/articles/1
블로그 글을 삭제하는 API	DELETE/articles/1