REST API

REST API: 웹과 소통을 하다

1320129

2023년 12월 21일 · 0 분 소요

REST API: 웹과 소통을 하다

웹 애플리케이션을 개발하는 과정에서, 데이터를 주고 받는 방식은 핵심적인 요소 중 하나입니다.

그 중에서도 REST API는 많은 개발자들이 선호하는 인터페이스 디자인 방식으로, 웹의 기본 구조와 특성을 최대한 활용하여 효율적인 커뮤니케이션을 가능하게 합니다.

그렇다면 REST API란 무엇일까요? 왜 이렇게 중요한 것일까요?

1. API (Application Programming Interface)

API는 애플리케이션 간에 데이터를 주고 받기 위한 '중개자' 같은 역할을 하는 인터페이스입니다.

다시 말해, 서로 다른 소프트웨어 사이에서 요청과 응답을 가능하게 하는 규약입니다.

2. HTTP 프로토콜과 웹

HTTP(Hypertext Transfer Protocol)는 클라이언트와 서버가 인터넷 상에서 데이터를 주고받기 위한 프로토콜입니다.

대부분의 웹 서비스는 HTTP 프로토콜 위에서 동작합니다.

HTTP 메서드(GET, POST, PUT/PATCH, DELETE 등)들은 각각 특정 타입의 요청을 나타냅니다.

이 메서드들은 대부분의 웹 기반 API에서 사용되며, 클라이언트가 서버에 어떤 작업을 수행해야 하는지 지시합니다.

3. REST (REpresentational State Transfer)

REST는 REpresentational State Transfer의 약자로, 웹의 장점을 최대한 활용할 수 있는 아키텍처 스타일입니다.

※이를 만든 Roy Fielding 박사는 HTTP 프로토콜 설계에 큰 기여를 한 중요한 인물입니다.

REST는 다음과 같은 구성 요소로 이루어져 있습니다:

자원(Resource): 웹 상에서 유일하게 식별되는 개체 또는 대상을 의미합니다.

URI(Uniform Resource Identifier): 자원을 식별하는 고유한 값으로, 각 자원은 고유한 URI를 가지고 있습니다.

메서드(Method): 서버에 클라이언트가 요청하는 종류를 나타내며, 주로 HTTP 메서드(GET, POST, PUT, DELETE 등)를 사용합니다.표현(Representation): 클라이언트와 서버가 데이터를 주고받는 형태로 JSON, XML 등 다양한 형식이 있습니다.

REST 아키텍처 스타일은 Stateless(상태 정보 유지 안함), Client-Server(클라이언트-서버 구조), Cacheable(캐싱 가능), Layered System(계층화 구조), Code-On-Demand(optional) 등의 특징을 가지고 있습니다.

Stateless (상태 정보 유지 안함): 서버가 클라이언트의 상태 정보를 기억하지 않습니다. 즉, 클라이언트가 요청을 보낼 때마다 필요한 모든 정보를 같이 보내야 합니다. 이렇게 하면 서버는 각 요청을 독립적으로 처리할 수 있습니다.
Client-Server (클라이언트-서버 구조): 클라이언트와 서버가 별개로 존재합니다. 클라이언트는 서버에게 요청을 보내고, 서버는 요청을 처리한 후 응답을 보냅니다. 이 구조 덕분에 클라이언트와 서버는 각각의 역할에 집중할 수 있습니다.
Cacheable (캐싱 가능): 서버의 응답은 클라이언트에게 임시로 저장될 수 있습니다. 즉, 클라이언트는 이전에 받은 응답을 재사용할 수 있습니다. 이렇게 하면 서버의 부하를 줄이고, 응답 시간을 단축할 수 있습니다.
Layered System (계층화 구조): 서버는 여러 계층으로 구성될 수 있습니다. 각 계층은 독립적으로 동작하며, 특정 계층은 다른 계층에 대한 세부 정보를 알 필요가 없습니다. 이렇게 하면 시스템을 유연하게 확장할 수 있습니다.
Code-On-Demand (optional): 필요에 따라 서버는 클라이언트에게 실행 가능한 코드를 전송할 수 있습니다. 이 기능은 선택적으로 사용할 수 있습니다.

4. REST API

그렇다면 REST API란 무엇일까요?

API(Application Programming Interface)란 어떤 소프트웨어나 애플리케이션의 기능들을 외부에서도 쉽게 사용할 수 있도록 만든 인터페이스입니다.

따라서 REST API란 REST 아키텍처 스타일을 따르며 HTTP 프로토콜 위에서 동작하는 API를 의미합니다.
URI와 HTTP 메서드(GET/POST/PUT/DELETE 등)만으로도 각 리소스에 대해 CRUD(Create Read Update Delete) 연산을 쉽게 수행할 수 있게 해줍니다.

예제 URL:

GET /users - 모든 사용자 정보 조회
POST /users - 새 사용자 생성
PUT /users/123 - id가 123인 사용자 정보 수정
DELETE /users/123 - id가 123인 사용자 정보 삭제

REST API를 통해 클라이언트와 서버 간의 데이터 교환을 쉽고 명확하게 처리할 수 있습니다.

이는 웹, 모바일 등 다양한 플랫폼에서 활용될 수 있어 매우 유연하며, 개발 및 유지보수 과정에서도 큰 장점을 제공합니다.

5. REST API의 장점

REST API는 다음과 같은 이유로 많은 개발자들에게 사랑받고 있습니다.

플랫폼 독립성: REST API는 HTTP를 기반으로 하므로, 어떤 플랫폼이든지 사용할 수 있습니다. 클라이언트가 무엇이든 상관없이 동일한 방식으로 서버와 통신할 수 있습니다.

언어 독립성: 데이터 교환에 표준인 JSON 혹은 XML을 사용하기 때문에, 어떤 프로그래밍 언어를 사용하더라도 문제 없이 해석하고 사용할 수 있습니다.

스케일 아웃 가능: Stateless한 특성 때문에, 서버가 확장되는 것을(스케일 아웃) 쉽게 할 수 있습니다.

직관적인 인터페이스: 리소스 지향 구조로 인해 직관적이며 이해하기 쉬운 인터페이스를 가지고 있습니다.

6. REST API의 단점

그러나 REST API도 완벽하지 않으며, 몇 가지 단점들이 존재합니다.

1.Over-fetching과 Under-fetching 문제: 클라이언트가 필요한 데이터만 정확하게 요청하는 것이 어렵기 때문에 필요 이상의 데이터(Over-fetching)를 가져오거나 필요한 데이터를 모두 가져오지 못하는(Under-fetching) 문제가 발생할 수 있습니다.

2.HTTP 상태 코드 부족: HTTP 상태 코드만으로 세부적인 에러 정보 전달에 한계가 있는 경우가 많아서 추가 정보 제공을 위해 별도의 에러 메시지 관리 및 전달 방식을 마련해야 합니다.

7. 결론

REST API는 웹 애플리케이션 개발에서 중추적인 역할을 합니다.

그런 만큼 개발자로서 이 기술을 숙달하는 것은 매우 중요합니다.

그리고 앞서 소개된 단점들 역시 고려하여 최선의 설계 방안을 찾아야 합니다.

REST API는 웹 개발의 핵심이며, 이에 대한 깊은 이해는 개발자로서 성장하는 데 큰 도움이 될 것입니다.