API란?

API(Application Programming Interface)란 프로그램끼리 서로 데이터를 주고받을 수 있게 해주는 약속이다. 앱에서 버튼을 누르면 서버에 요청을 보내고, 서버가 필요한 정보를 보내주는 과정이 바로 API를 통해 이루어진다.

API, 왜 중요할까?

1. 프로그램끼리 쉽게 연결할 수 있다
   API 덕분에 서로 다른 시스템이나 서비스가 빠르고 쉽게 통신할 수 있다.

2. 개발 시간을 줄여준다
   필요한 기능을 직접 만들 필요 없이, 이미 만들어진 API를 가져다 쓰면 된다.

3. 서비스 확장에 유리하다
   내 서비스를 외부에 공개하면, 다른 사람들이 API를 이용해 새로운 앱이나 기능을 만들 수 있다.

4. 일관성과 보안 유지
   정해진 규칙에 따라 통신하기 때문에, 시스템이 커져도 관리가 쉽고 보안도 강화할 수 있다.

API종류

API 종류에는 대표적으로 REST API와 GraphQL이 있다.

REST API

REST API(Representational State Transfer)는 대표적인 API이다. 웹의 기본 원칙을 따르며, 클라이언트와 서버가 HTTP를 통해 리소스(데이터)를 주고받는 방식이다.

REST API의 구성 요소

1. 리소스 (Resource)
   • 리소스는 서버에 존재하는 모든 데이터(객체)이다.
   • 리소스는 각각 고유한 URI로 식별된다.

2. HTTP 메서드
   REST에서는 HTTP 메서드를 통해 리소스에 대한 행동(Action)을 구분한다.
   • GET: 리소스 조회
   • POST: 리소스 생성
   • PUT: 리소스 전체 수정
   • PATCH: 리소스 부분 수정
   • DELETE: 리소스 삭제

3. URI(Uniform Resource Identifier)
   • 리소스는 URI로 접근한다.
   • URI는 리소스를 “무엇”인지만 나타내야 하고, “무슨 행동”을 하는지는 메서드로 구분한다.

4. 표현(Representation)
   • 리소스 자체가 아닌, 리소스를 표현하는 데이터를 주고받는다.

REST API의 장점

• 단순 & 직관적
URL과 메소드만 잘 알면 쉽게 사용할 수 있다.

• 확장성 & 유연성
새로운 기능을 추가해도 구조를 크게 변경할 필요가 없다.

• 표준 HTTP 사용
브라우저, 서버, 앱 어디서나 쉽게 구현 가능하다.

• 캐싱 가능
캐싱이란 자주 사용하는 데이터를 빠르게 꺼내 쓰기 위해 임시로 저장해두는 것이다. HTTP 캐시를 통한 GET 요청은 성능을 최적화할 수 있다.

REST API의 한계

복잡한 데이터 요청이 필요한 경우 여러 번 요청해야 할 수도 있다. 또한, 고정된 데이터 구조로 인해 클라이언트가 원하지 않는 데이터까지 받을 수 있다.

GraphQL

이러한 한계를 극복하기 위해 GraphQL 같은 방식이 등장했다.

GraphQL의 구성 요소

1. Query: 서버에게 어떤 데이터를 달라고 요청하는 문서이다.

2. Mutation: 데이터를 수정, 추가, 삭제할 때 사용한다.

3. Subscription: 서버에서 클라이언트로 실시간 데이터를 보내주는 기능이다.

또 하나 중요한 건, GraphQL 서버는 항상 Schema(스키마)를 기반으로 작동한다는 것이다. Schema(스키마)는 서버에 존재하는 데이터가 무엇이며, 어떤 모양(구조)이고, 서로 어떻게 연결되어 있는지를 명확히 정의한 문서이다. GraphQL에서는 이 스키마가 어떤 쿼리(Query), 데이터 타입(Type), 관계(Relationship), 수정(Mutation)이 가능한지를 모두 결정하기 때문에 스키마를 보면, 이 서버에 어떤 데이터를 어떻게 요청할 수 있을지 한눈에 알 수 있다.

GraphQL의 장점

• 필요한 데이터만 요청하니 네트워크 낭비가 없다.

• 하나의 요청으로 여러 데이터 집합을 받을 수 있다.

• API 버전 관리가 필요 없다.

• 스키마 기반이기 때문에 문서화가 자동으로 가능하다.

GraphQL의 단점

• 스키마 작성, 리졸버 설정 등으로 인햐 서버 개발이 복잡할 수 있다.

• 캐싱이 REST보다 까다롭다.

• 간단한 API라면 오히려 과한 느낌이 들 수도 있다.