✍️ API 와 Server API

📌 API
프로그램의 명령 목록을 정리하고 응용프로그램과 상호작용하여 명령에 대한 값을 전달한다.
📌 Server API
요청에 맞는 응답을 되돌려주는 EndPoint를 웹을 통해 노출시킨 것을 말한다.
📌 EndPoint
API가 서버에서 리소스에 접근할 수 있게 하는 URL이다.

✍️ REST API 이해하기

1. REST 와 REST API

• REpresentational State Transfer
  👉 리소스의 표현에 대한 상태 전달
• 모든 리소스를 하나의 EndPoint로 연결하고 리소스마다 각 EndPoint로 관리하는 네트워크 기반 아키텍처를 말한다.
• HTTP URI로 리소스를 명시하고 HTTP METHOD를 통해 리소스에 대한 CRUD Operation을 적용한 것을 의미한다.
  👉 URI는 리소스를 식별하고 나타내는 주소를 말한다.
  👉 URI는 URL과 URN을 포함한 개념이다.

2. 장점과 단점

✅ 장점

• 의도를 명확히 파악할 수 있다.
• HTTP 프로토콜을 사용하여 인프라를 구축하지 않아도 된다.
• stateless 특징에 따라 서버가 클라이언트 문맥을 유지할 필요가 없어 서버와 클라이언트가 분리됐다.
  👉 업무량 감소와 HTTP 표준을 따르는 다양한 플랫폼에서 호환이 가능하다.

⛔️ 단점

• 사용할 수 있는 METHOD 형태가 제한적이다.
• 표준이 존재하지 않는다.

✍️ GraphQL 이해하기

1. 배경

• 페이스북에서 개발한 Query Language다.
  👉 Query Language는 정보를 얻기 위한 질의문을 만들기 위해 사용되는 컴퓨터 언어다.
• REST API 통신의 한계로 인해 탄생하게 됐다.
  👉 특정 기능, 요청에 따라 여러번 API가 호출되거나 새로운 API를 만들어야한다.
  👉 관리해야할 EndPoint 증가로 인한 문제가 발생한다.

2. 특징

• 단 하나의 EndPoint만 존재하여 한번의 요청으로 모든 정보를 가져온다.
• Query문에 따라 다른 응답구조를 가진다.
• Client-Side 와 Server-Side 모두 통신을 주고 받을 수 있다.

3. 장점과 단점

✅ 장점

• 하나의 EndPoint만 가지기 때문에 요청횟수가 줄어들고 유지보수가 용이해졌다.
• 원하는 정보만 요청하여 Overfetching, Underfetching 문제를 해결했다.
  👉 Overfetching : 원하는 데이터 이상으로 받는 것
  👉 Underfetching : 원하는 데이터를 요청하기 위해 여러번 요청하는 것

⛔️ 단점

• HTTP의 캐싱 전략은 각각의 URL에 저마다의 정책을 설정하는 형식으로 이루어져 GraphQL 특성상 그대로 사용할 수 없다.
  👉 GraphQL만의 캐싱 방식인 영속쿼리, 아폴로 엔진 등이 있다.
• 완성된 명세가 존재하지 않는다.
  👉 파일업로드를 직접 구현해야한다.
• 클라이언트가 필요한 데이터를 결정하기 때문에 잘못된 요청을 필터링하기 까다롭다.