HTTP 통신과 API

양세희·2022년 5월 11일
0
post-thumbnail

HTTP 통신

HTTP란 두 컴퓨터간에 텍스트 데이터를 주고 받는 길이다.

HTTP 라는 길로 요청(request)과 응답(response) 두 가지를 서로 주고 받을 수 있다.

HTTP 요청(request)과 응답(response)

HTTP 요청(Request)

웹브라우저에서 홈페이지(Front-end)가 실행중이라면, 작성한 게시물 텍스트 데이터를 HTTP를 통해 Back-end 컴퓨터로 보내고 Back-end 컴퓨터에게 이 데이터를 데이터베이스에 저장 해달라고 요청한다.

HTTP 응답(Response)

요청을 받은 Back-end 컴퓨터가 성공, 실패 등 처리 결과를 응답한다.

응답 상태코드

Back-end 컴퓨터는 응답할 때, 응답 상태코드 라는 것도 함께 보내준다.
응답 상태코드는 100~ 599까지의 숫자로 구성되어 있고, 자주 볼 수 있는 응답 상태코드는 성공(200), Front-end 에러(400), Back-end 에러(500) 등이 있다.
예를 들면, 요청에 성공했으면 성공 메시지와 응답 상태코드 200을 함께 보내준다.

그럼 데이터베이스에 바로 요청하면 안되는건가?
보안 및 데이터 정제 등의 이유로 Back-end에서 검증 과정을 거쳐야 하기 때문에, 아무나 함부로 데이터 베이스에 요청할 수 없다.

API

API란 HTTP 요청을 Back-end 컴퓨터에 보냈을때 실행되는 Back-end 기능이다.
Front-end에서 HTTP라는 길을 통해서 게시물 데이터를 Back-end에 보내 저장시켰다고 가정해보자. 만약, 게시물이 아닌 프로필 데이터를 저장하고 싶으면 어떻게 해야 할까?

그러기 위해선, 여러개의 HTTP 라는 길이 존재해야 하고, 각각의 요청마다 담당자가 필요하다. 우리는 이 담당자를 API 라고 부른다.

API가 기능 이라고 했는데, 기능은 함수라고 봐야 하는 것 아닌가?
맞다. 정확히는 Back-end 개발자가 만든 함수이다. 함수는 인자와 return 데이터가 있는데, API에 요청할 때 보내는 데이터는 API 함수로 들어갈 인자이고, 응답으로 받게되는 데이터가 API 함수의 return 데이터이다.

API 종류(rest-API vs graphql-API)

API의 종류는 크게 rest-API, graphql-API 두 가지가 있다.
rest-API 와 graphql-API 는 몇가지 차이점이 있다.

함수 이름의 차이

rest-API는 API 이름이 마치 홈페이지 주소처럼 생겼다.
graphql-API는 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는 배우지 않아도 되는건가?
그렇지 않다. 우선 웹 개발은 혼자 하는 것이 아니기 때문에 내가 속한 회사나 팀에서 rest를 사용하고 있을 수도 있다. 그리고 다른 회사에서 제공해주는 API를 사용하는 경우도 있다. 예를 들면, 카카오로 로그인하기 기능은, 카카오에서 제공해주는 API를 사용해야 하는데, 이러한 기능들은 대부분 rest-API로 제공되고 있다. 이러한 이유로 rest-API 또한 배워야 한다.

API와 CRUD

API는 크게 4가지 방식으로 구분할 수 있다.

  1. 새로운 것을 생성하는 APICREATE
  2. 기존의 것을 조회하는 APIREAD
  3. 기존의 것을 수정하는 APIUPDATE
  4. 기존의 것을 **삭제하는 API**DELETE

실제 사용 방법은 아래와 같다.

API 명세서

API 명세서는 API 사용 설명서이다.

홈페이지를 만들기 전, Back-end 개발자가 만들어 놓은 API가 몇개 있고, 어떻게 구성되어있는지 확인하기 위해 필요하다.

API명세서는 Back-end 개발자에게 받아야 한다. Back-end 개발자는 자신이 만든 API를 직접 문서 형태로 작성하거나, swagger라는 프로그램을 설치해서 만든다.

API 요청 결과 타입(JSON)

JSON이란 무엇일까?

API 요청의 결과를 자세히 보시면 자바스크립트(Javascript)의 객체(Object)처럼 표기(Notation)되어 있다.

{
classmate: "철수",
age: 13
}

이것의 앞글자를 따서 API의 요청 결과 타입을 JSON이라고 부른다.

정리하면

-HTTP란 두 컴퓨터간에 텍스트 데이터를 주고 받는 길이다.

-웹브라우저에서 홈페이지가 실행중이면, 작성한 게시물 텍스트 데이터를 HTTP를 통해 Back-end 컴퓨터로 보내고 Back-end 컴퓨터에게 이 데이터를 데이터베이스에 저장 해달라고 요청한다. 그리고 요청을 받은 Back-end 컴퓨터가 성공, 실패 등 처리 결과를 응답한다.

-API란 HTTP 요청을 Back-end 컴퓨터에 보냈을때 실행되는 Back-end 기능이다.

-API의 종류는 크게 rest-API, graphql-API 두 가지가 있고, rest-API와 graphql-API는 함수 이름과 응답 결과물의 차이가 있다.

-API는 크게 4가지 방식으로 구분할 수 있다. (CRUD)

-API 명세서는 API 사용 설명서이다.

-API의 요청 결과 타입을 JSON이라고 부른다.

1개의 댓글

comment-user-thumbnail
2022년 6월 29일

좋은 글 감사합니다.

답글 달기