REST-API vs GraphQL-API

정승원·2023년 4월 4일

📒 목차

📌 REST-API란?

📌 GraphQL-API란?

📌 참조

REST는 REpresentational State Transfer라는 용어의 약자이며,

REST API는 말 그대로 REST형식의 API를 말한다.

REST API란 핵심 컨텐츠 및 기능을 외부 사이트에서 활용할 수 있도록 제공되는 인터페이스이다.

예를 들어, 네이버에서 블로그에 글을 저장하거나, 글 목록을 읽어갈 수 있도록 외부에 기능을 제공하거나 우체국에서 우편번호를 조회할 수 있는 기능을 제공하거나, 구글에서 구글 지도를 사용할 수 있도록 제공하는 것들을 말한다.

REST API는 웹 브라우저 뿐만 아니라 앱 등 다양한 클라이언트가 등장하면서 그러한 클라이언트들에게 대응하기 위해 사용되기 시작했다.

서비스 업체들이 다양한 REST API를 제공함으로써, 클라이언트는 이러한 REST API들을 조합한 어플리케이션을 만들 수 있게 되었다.

이것을 매시업(Mashup)이라고 한다.

이렇게 REST API가 널리 사용되게 되었지만, REST를 논문으로 최초 소개한 로이필딩은 대부분의 REST API라고 하는 것들이 REST API가 아니라고 말하는데, 그 이유는 아해와 같은 스타일을 지키지 못한 경우가 많았기 때문이다.

즉, 위에서 언급한 내용을 잘 지켜야만 REST라고 말할 수 있다.

GraphQL은 페이스북에서 만든 쿼리 언어이다.

gql은 웹 클라이언트가 데이터를 서버로부터 효율적으로 가져오는 것이 목적이다.

gql의 문장은 주로 클라이언트 시스템에서 작성하고 호출 한다.

쿼리/뮤테이션(query/mutation)
쿼리와 뮤테이션 그리고 응답 내용의 구조는 직관적이다. 요청하는 쿼리문의 구조와 응답 내용의 구조는 거의 일치한다.

아래 사진의 좌측은 쿼리문이고, 우측은 응답에이터 형식이다.

gql에서는 굳이 쿼리와 뮤테이션을 나누는데 내부적으로 들어가면 사실상 이 둘은 별 차이가 없다.

쿼리는 데이터를 읽는데(R) 사용하고, 뮤테이션은 데이터를 변조(CUD) 하는데 사용한다는 개념 적인 규약을 정해 놓은 것 뿐이다.