RESTful API [Representational State Transfer]
이해하기 쉽고 사용하기 쉬운 서비스 API를 제공하기 위해 REST원리에 따라 구현한 것.
REST API를 제공하는 웹서비스를 'RESTful 하다'고 할 수 있다.
근데 그 전에...
-
API????
Application Programing Interface 의 약자로, 어떤 프로그램에서 사용할 수 있게 프로그래밍 언어나 데이터를 주고 받기 위한 방법/규격 (interface).
(흔히 업체쪽에서 API를 제공하지 않는다는 건 보내는 측에서 정보를 제공하지 않는다는 의미.) -
REST????
Representatioal State Transfer의 약자.
자원(resource)을 그 자원의 이름(자원의 표현)으로 구분해서 그 자원의 상태를 주고 받는 모든 것을 뜻함.
자원을 명시하여 HTTP Method를 통해 그 자원을 처리하도록 설계된 것.
cf.>문서나 그림이나 데이터 등이 자원. 그리고 만약 학생 정보가 자원이면 'student'를 자원의 표현(이름)으로 정함 -
특징
Server-Client(서버-클라이언트 구조) ;자원이 있는 쪽이 Server, 자원을 요청하는 쪽이 Client.
HTTP프로토콜이 stateless여서 REST도 무상태성.
상태정보를 따로 저장하거나 관리하지 않고 api서버는 단순히 들어오는 요청만을 처리한다는 등 많지만 제일 중요한 특징은..
"self-descriptiveness"!
RESTful API는 그 자체만으로도 API의 목적이 쉽게 이해됨
<example>
HTTP GET https://api.trueshort.com/stock/005930 `
//문서나 주석이 없이 상위 "https://api.trueshort.com 라는 API에서 삼성전자 주식에 관한 정보를 HTTP 요청을 통해 받아오는 구나" 라는 해석이 가능- 네이밍 패턴
-URI는 정보의 자원을 표현해야 함
자원에 대한 행위는 HTTP Method(GET, POST, PUT, DELETE)로 표현
-/(슬래시)는 계층 관계를 나타냄
<example 1>
https://api.trueshort.com/kospi/stock/005930
//KOSPI에 속해있는 주식(Stock) 중 삼성전자(005930)을 나타냄<example 2>
https://api.shopping.com/books/novel/stephenking
// 책들중 소설 그리고 소설중 Stephen King의 소설을 나타내는 구조
주소에는 명사(해당 주체) , 동사는 메서드로. 그 자체만으로 목적이 보이게. -가독성을 위해 URI에 _(underscore)는 주로 포함 x,
영어 대문자보다는 소문자 사용 & URI는 명사 사용
<example 3>
/books/novel/stephenking 이라고 하지 /books/novel/get-stephenking 이라고 안씀
-> 동사는 GET, POST 같은 HTTP Method를 통해 표현하기 때문.