API란?
API는 Application Programming Interface의 약자입니다.
wiki를 보면 API에 대한 설명이 다음과 같이 되어 있습니다.
“API(Application Programming Interface, 응용 프로그램 프로그래밍 인터페이스)는 응용 프로그램에서 사용할 수 있도록,
운영 체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스를 뜻합니다."
주로 파일 제어, 창 제어, 화상 처리, 문자 제어 등을 위한 인터페이스를 제공합니다.
REST API란?
REST는 REpresentational State Transfer라는 용어의 약자로서 2000년도에 로이 필딩 (Roy Fielding)의 박사학위 논문에서 최초로 소개되었습니다.
REST API란 말 그대로 REST형식의 API를 말합니다.
REST API란 핵심 컨텐츠 및 기능을 외부 사이트에서 활용할 수 있도록 제공되는 인터페이스입니다.
예를 들어, 네이버에서 블로그에 글을 저장하거나, 글 목록을 읽어갈 수 있도록 외부에 기능을 제공하거나 우체국에서 우편번호를 조회할 수 있는 기능을 제거하거나, 구글에서 구글 지도를 사용할 수 있도록 제공하는 것들을 말합니다.
웹 브라우저 뿐만 아니라 앱 등 다양한 클라이언트가 등장하면서 그러한 클라이언트들에게 대응하기 위해 REST API가 널리 사용되기 시작하였습니다.
서비스 업체들이 다양한 REST API를 제공함으로써, 클라이언트는 이러한 REST API들을 조합한 어플리케이션을 만들 수 있게 되었습니다.
이를 매시업(Mashup)이라고 합니다.
이것은 REST가 아니다.
이렇게 REST API가 널리 사용되었지만, REST를 논문으로 최초 소개한 로이필딩은 대부분의 REST API라고 하는 것들이 REST API가 아니라고 말합니다.
REST는 다음과 같은 스타일을 반드시 지켜야 한다고 말합니다.
- client-server
- stateless
- cache
- uniform interface
- layered system
- code-on-demand (optional)
여기서 스타일이란 제약조건의 집합을 의미합니다.
즉, 위에서 언급한 내용을 잘 지켜야만 REST라고 말할 수 있다는 의미입니다.
HTTP프로토콜을 사용한다면 client-server, stateless, cache, lared system, code-on-demand 등에 대해서는 모두 쉽게 구현 가능합니다.
하지만, 문제는 uniform interface입니다.
uniform interface의 스타일
- 리소스가 URI로 식별되야 합니다.
- 리소스를 생성,수정,추가하고자 할 때 HTTP메시지에 표현을 해서 전송해야 합니다.
- 메시지는 스스로 설명할 수 있어야 합니다. (Self-descriptive message)
- 애플리케이션의 상태는 Hyperlink를 이용해 전이되야 합니다.(HATEOAS)
첫 번째와 두 번째 항목은 지키기 어렵지 않은데, 메시지가 스스로 설명할 수 있어야 하는 부분과 HATEOAS를 지원하는 것은 웹과는 다르게 API로는 쉽지가 않습니다.
응답 결과에 보통 JSON 메시지를 사용하게 되는데, 이 JSON메시지가 어디에 전달되는지 그리고 JSON메시지를 구성하는 것이 어떤 의미를 표현해야만 메시지 스스로 설명할 수 있다고 말할 수 있는데, 그게 쉽지 않습니다.
우리가 웹 게시판을 사용할 때, 리스트 보기를 보면, 상세보기나 글쓰기로 이동할 수 있는 링크가 있습니다.
상세보기에서는 글 수정이나 글 삭제로 갈 수 있는 링크가 있습니다.
이렇게 웹 페이지를 보면, 웹 페이지 자체에 관련된 링크가 있는것을 알 수 있는데 이를 HATEOAS라고 말합니다.
이런 HATEOAS를 API에서 제공하는 것은 쉽지 않습니다.
REST API는 쉽지 않다. 그래서, 보통은 Web API(혹은 HTTP API)를 사용한다.
REST의 uniform interface를 지원하는 것은 쉽지 않기 때문에, 많은 서비스가 REST에서 바라는 것을 모두 지원하지 않고 API를 만들게 됩니다.
- REST의 모든 것을 제공하지 않으면서 REST API라고 말하는 경우도 있습니다.
제가 최근 개발하고 있는 프로젝트의 백엔드를 구축하면서 다양한 종류의 클라이언트와 통신하는 방법을 알아보던 중 REST API를 알게 되어 도대체 REST API가 무엇인지 공부하던 중 깔끔하게 정리해준 자료를 발견하게 되어 이렇게 공유합니다.
저는 제가 쓰고 있는 방법이 REST API인줄 알았는데 정확하게는 Web API(HTTP API)를 사용하고 있는 중이었군요.
API 사용 예제나 좀 더 심화된 내용은 추후 포스팅 하도록 하겠습니다.
