[TIL] REST-API와 GraphQL-API의 차이점

[이미지 출처] https://graphql.org/

GraphQL이란?

GraphQL은 최근 개발자들 사이에서 빠른 속도로 인기가 상승 중이다.
이 GraphQL은 2012년에 페이스북에서 만든 쿼리 언어이다.
SQL의 QL이 Query Language을 의미하는데 SQL은 데이터베이스 시스템에 저장된 데이터를 효율적으로 가져오는 것이 목적이라면, 이 GraphQL은 웹 클라이언트가 서버로부터 데이터를 효율적으로 가져오는 것을 목적으로 만든 쿼리 언어인 것이다. 이 GraphQL은 현재 Facebook, Airbnb, Github 등의 유명한 사이트에서 사용 중인 통신 방법이라고 한다.

 

REST-API를 두고 왜??

그렇다면 사람들이 통상적으로 많이들 사용하고 있는 REST-API를 두고 왜 GraphQL을 사용하는 것인지 궁금했다.
REST-API와 GraphQL의 차이점으로는 크게 3가지가 존재한다.

1. 함수 이름의 차이

만일 네이버에서 1번 게시글 조회라는 API가 있다면,

REST-API에선 https://naver.com/board/1 이런식으로 API 이름이 홈페이지 주소처럼 생겼다.

하지만, GraphQL에선 API 이름이 board(1) 이렇게 일반적인 함수처럼 생겼다.

 

	axios (REST-API)	apollo-client (GraphQL-API)
조회 READ	GET	QUERY
생성 CREATE	POST	MUTATION
수정 UPDATE	PUT
삭제 DELETE	DELETE

 

axios 요청 예시

import axios from 'axios'

const result = axios.get(API 이름 입력)
const result = axios.post(API 이름 입력)
const result = axios.put(API 이름 입력)
const result = axios.delete(API 이름 입력)

 

apollo-client 요청 예시

import { useMutation, useQuery } from '@apollo/client'

const result = useMutation(API 이름 입력)
const result = useQuery(API 이름 입력)

 

2. response 결과물의 차이

사실 이 특징이 GraphQL의 가장 큰 장점이 아닐까 싶다.

REST-API는 response 결과로 백엔드에서 보내주는 모든 데이터를 받아야만 한다.

하지만, GraphQL API는 요청할 때 사용하는 쿼리문에 따라 백엔드 단의 함수에서 필요한 데이터만 선택적으로 응답을 받아올 수 있다는 특징을 지닌다.  이렇게 필요한 데이터만 골라 받을 수 있어서, 효율적인 통신을 할 수 있어서 유연하다는 장점을 가진다.

RESTful의 경우는 필요한 리소스 별로 별도 요청을 보내야 했다면, GraphQL은 원하는 정보를 하나의 쿼리에 모두 담아 요청을 보낼 수 있어 HTTP 요청 횟수를 줄일 수 있다. 또한, HTTP의 응답 사이즈를 줄일 수 있다. 이 GraphQL을 Facebook이 개발한 초기 이유 중 하나가 모바일 사용의 증가 때문이라고 한다. 모바일에서 통신을 효율적으로 하기 위해선 데이터 사이즈를 최소화하여 모바일 환경의 부담을 줄여줘야 하기에 응답 사이즈를 줄여줄 수 있는 GraphQL을 개발한 것이다.

 

3. 설치해야 할 프로그램의 차이

통신 방법의 차이가 있기 때문에, 당연히 설치해야 할 프로그램도 다르다.

프로젝트를 해본 사람들은 알겠지만, REST-API를 사용하기 위해선 axios를 설치해주어야 한다.

GraphQL은 axios 대신 apollo-client라는 라이브러리를 설치해주어야 한다.

 

그럼 REST-API는 몰라도 되나요?

물론 아니다. GraphQL도 당연히 단점이 존재한다.

 

1. 파일 업로드 😢

GraphQL은 원칙적으로 multipart/from-data 형식을 받을 수 없고 application/json 형식만 받을 수 있다. File 전송 등 Text만으로는 하기 힘든 내용들을 처리하기 복잡해지는 것이다. GraphQL의 방식을 사용할 때 파일 전송이 아예 불가능한 것은 아니지만, multipart를 json으로 바꿔주는 미들웨어나 패키지를 사용해야 해서 까다롭다는 단점이 존재한다.

 

2. Query의 크기 😢

고정된 요청과 응답만 필요한 경우에도 Query를 모두 작성해주어야 하기에 REST-API를 사용할 때보다 크기가 더 커진다는 단점이 존재한다.

 

3. 복잡한 캐싱 😢

HTTP의 캐싱 전략은 각각의 URL에 저마다의 정책을 설정하는 형식으로 이루어진다.

반면에, GraphQL은 모든 데이터를 하나의 URL을 두고 여기에 쿼리를 전송하여 응답을 받는 형식으로 작동된다. 그래서 GraphQL은 HTTP에서 제공하는 캐싱 전략을 그대로 사용할 수 없다. 따라서, GraphQL만의 캐싱 방식을 찾아야 한다는 단점이 있다.

 

따라서, 상황에 따라 REST-API가 더 효율적인 경우가 존재한다.

그리고,  현재까지는 아직 REST 방식이 더 널리 쓰이고 있어서 REST-API의 사용법도 알고 있어야 한다. 또한, Open API들이 대부분 REST-API로 제공된다.