REST API
REST는 Representational State Transfer의 약자로, 웹 서비스 간 통신을 위한 아키텍처 스타일 중 하나입니다. HTTP 프로토콜을 사용하여 리소스를 표현하고 상태를 전달하며, 클라이언트와 서버 간의 효율적이고 표준화된 통신을 가능하게 합니다.
REST API는 로이 필딩(Roy Fielding) 박사의 박사 학위 논문에서 처음 소개되었으며, 웹에서 정보 교환을 위한 네트워크 아키텍처를 정의하고 있습니다.
REST 아키텍처 원칙: REST API는 다음과 같은 핵심 원칙을 따릅니다.
- Resource Identification:
각 리소스(데이터 또는 객체)는 URI(Uniform Resource Identifier)를 통해 고유하게 식별됩니다. - Stateless:
각 요청은 필요한 모든 정보를 포함하며, 서버는 이전 요청의 상태를 저장하지 않고 독립적으로 처리합니다. - Connectivity:
클라이언트와 서버의 상호작용은 요청(Request)과 응답(Response)으로 구성되며, 필요한 정보만을 포함합니다. - Client-Server:
클라이언트와 서버는 서로 독립적으로 개발되며, 상호 간 내부 로직을 서로 알 필요가 없습니다.
HTTP Method와 Resource
RESTful API는 HTTP Method(GET, POST, PUT, DELETE 등)를 사용하여 Resource에 접근하고 이를 처리합니다.
- POST → Resource 생성(Create)
- GET → Resource 조회(Read)
- PUT → Resource 수정(Update)
- DELETE → Resource 삭제(Delete)
RESTful API는 URL을 통해 Resource를 식별하고, HTTP Method를 사용하여 해당 Resource와 상호작용합니다.
예를 들어, “/user/jay”라는 URL로 “GET” 요청을 보내면, 서버는 “user” 하위에 있는 “jay”라는 Resource를 조회하여 응답을 반환합니다.
HTTP Resoponse Status Code
REST API는 응답 시 상태 코드(Status Code)를 함께 반환하며, 자주 사용되는 대표적인 코드는 다음과 같습니다.
- 200 OK: 요청이 성공적으로 처리되었습니다.
- 201 Created: 요청에 의해 새로운 Resource가 성공적으로 생성되었습니다.
- 400 Bad Request: 요청 문법이 잘못되어 서버가 요청을 이해할 수 없습니다.
- 404 Not Found: 요청한 Resource를 서버에서 찾을 수 없습니다.
- 500 Internal Server Error: 서버 내부 오류로 인해 요청을 처리할 수 없습니다.
“404 Not Found”는 웹 브라우저 사용 시 가장 흔히 접하게 되는 오류 코드 중 하나입니다.
REST API 활용 사례
REST API는 다양한 분야에서 폭넓게 활용되고 있습니다. 대표적인 활용 사례는 다음과 같습니다.
- 웹 및 모바일 애플리케이션: 소셜 미디어 앱에서 사용자 프로필, 게시글, 팔로워 목록 등을 업데이트하거나 조회하는 데 REST API가 활용됩니다.
- 클라우드 서비스 연동: Dropbox, Google Drive와 같은 클라우드 서비스는 REST API를 통해 파일 및 데이터 공유 기능을 제공합니다.
- IoT(사물인터넷): IoT 기기와 애플리케이션은 RESTful API를 통해 서로 및 클라우드 서비스와 통신합니다.
- 결제 시스템: 온라인 결제 플랫폼은 REST API를 활용해 결제 처리, 카드 정보 관리, 결제 게이트웨이 연동을 수행합니다.
- 소프트웨어 연동: 기업 시스템 간 데이터 공유 및 자동화를 위해 REST API가 활용됩니다.
- 데이터 분석 및 시각화: 외부 데이터를 REST API로 수집하여 실시간 데이터 표시 및 보고서 생성을 지원합니다.
- 소셜 미디어 연동: 소셜 미디어 플랫폼은 공유, 인증, 사용자 데이터 접근 기능을 API 형태로 제공합니다.
이 외에도 REST API는 다양한 산업과 애플리케이션 전반에서 서로 다른 소프트웨어 시스템 간의 원활한 통신과 데이터 교환을 위해 폭넓게 활용되고 있습니다.