⭐ API === Back-end 개발자가 만든 함수
API 요청할 때 보내는 데이터 === API 함수로 들어갈 인자
응답으로 받게 되는 데이터 === API 함수의 return데이터
API란 HTTP 요청을 Back-end 컴퓨터에 보냈을 때 실행되는 Back-end 기능입니다.
Front-end 에서 HTTP라는 길을 통해서 게시물 데이터를 Back-end에 보내 저장시켰습니다.
만약, 게시물이 아닌 프로필 데이터를 저장하고 싶으면 어떻게 해야 할까요?
그러기 위해선, 여러개의 HTTP라는 길이 존재해야 하고, 각각의 요청마다 담당자가 필요합니다.
우리는 이 담당자를 API라고 부릅니다.
⭐ API 배우는 이유
백엔드에서 준 데이터를 사용하기 위해!!!
⭐ API가 기능이라고 했는데, 기능은 함수 아닌가요?
정확합니다! Back-end 개발자가 만든 함수입니다. 함수는 인자와 return데이터가 있었죠?!
API에 요청할 때 보내는 데이터는 API 함수로 들어갈 인자이고, 응답으로 받게 되는 데이터가 API 함수의 return 데이터입니다.
API와 CRUD
API는 크게 4가지 방식으로 구분할 수 있습니다.
- 새로운 것을 생성하는 API ⇒ CREATE
- 기존의 것을 조회하는 API ⇒ READ
- 기존의 것을 수정하는 API ⇒ UPDATE
- 기존의 것을 삭제하는 API ⇒ DELETE
API 명세서
API 명세서는 API 사용 설명서입니다.
홈페이지를 만들기 전, Back-end 개발자가 만들어 놓은 API가 몇 개 있고, 어떻게 구성되어있는지 확인하기 위해 필요합니다.
API 명세서는 Back-end개발자에게 받아야 합니다. Back-end 개발자는 자신이 만든 API를 직접 문서 형태로 작성하거나, swagger라는 프로그램을 설치해서 만듭니다.
⭐ API 종류(rest-API vs graphql-API)
API의 종류는 크게 rest-API, graphql-API 로 2가지가 있습니다.
rest-API 와 graphql-API는 몇 가지 차이점이 있습니다.
⭐응답 결과물의 차이
rest-API 는 응답 결과로 back-end 개발자가 만든 함수에서 보내주는 모든 데이터를 받아야만 합니다.
반면에, graphql-API는 back-end 개발자가 만든 함수에서 필요한 데이터만 골라 받을 수 있습니다.
이러한 이유로, 각 API에 전송을 요청하는 담당자도 다릅니다.
rest-API에 요청하는 요청담당자는 axios입니다.
graphql-API에 요청하는 요청담당자는 apollo-client입니다.
요청담당자는 Front-end에서 설치하는 라이브러리입니다.
graphql은 필요한 데이터만 골라 받을 수 있는 장점이 있어서, 효율적인 통신을 할 수 있습니다.
graphql은 페이스북에서 발생하는 수많은 데이터를 처리하기 위해 페이스북 개발팀에서 만들었으며, facebook, airbnb, github 등 유명한 사이트에서 사용중인 통신 방법입니다.
❓ 그러면, rest-API는 배우지 않아도 되나요?
우리는 더 효율적인 방식의 graphql을 위주로 수업을 진행합니다.
그럼에도 불구하고, rest를 배워야하는 이유는 2가지가 있습니다.
1. 웹 개발은 혼자하는 것이 아닙니다. 내가 취업한 회사/팀에서 rest를 사용중일 수도 있습니다.
2. 다른 회사에서 제공해주는 API를 사용하는 경우도 있습니다. 예를들면, 카카오로그인 기능은, 카카오에서 제공해주는 API를 사용해야 하는데, 이러한 기능들은 대부분 rest-API로 제공되고 있습니다.
