REST API란?

🤓
프로젝트를 진행하면서 REST API라는 단어를 계속 듣게 되었는데 대충은 그 의미를 알겠지만 좀 더 자세히 알고 싶다는 생각이 들어서 정리하게 되었다.

API

API(Application Programming Interface) : 서로 다른 소프트웨어 시스템이 통신할 수 있도록 하는 규칙과 도구의 집합.

• 소프트웨어 간의 "계약" -> 어떻게 상호작용할 지 정의함
• 중개자 역할 -> 한 프로그램이 다른 프로그램의 기능이나 데이터에 접근할 수 있게 함
• 추상화 계층을 제공 -> 복잡한 내부 구현을 숨기고 간단한 인터페이스만 노출함

REST API(RESTful API)

• 웹 서비스를 구축하는 아키텍처 스타일
• 애플리케이션 통합, 아키텍처의 구성요소를 연결하는 방법 제공
• JSON이나 XML과 같은 형식으로 데이터를 주고 받음
• 웹, 모바일 앱, IoT 장치 등 다양한 곳에서 활용됨

REST 설계 원칙

균일한 인터페이스

• 같은 리소스는 항상 동일한 방식으로 접근할 수 있어야 함
• 하나의 데이터는 하나의 URI(주소)에만 존재해야 함
• 리소스는 적절한 크기로 설계되어 필요한 모든 정보를 포함해야 함
• 예시) 사용자 정보는 항상 /users/{id}로 접근, 어디서 요청하든 동일한 형식으로 응답

클라이언트-서버 분리

• 클라이언트와 서버는 독립적으로 존재하고 발전함
• 클라이언트는 리소스의 URI만 알면 됨
• 서버는 클라이언트에 데이터만 전달하고 클라이언트를 수정하지 않음
• 예시) 웹 브라우저(클라이언트)와 웹 서버는 서로의 내부 구조를 몰라도 통신 가능

무상태

• 각 요청은 독립적이며 이전 요청과 무관함
• 모든 요청에는 처리에 필요한 모든 정보가 포함되어야 함
• 서버는 클라이언트의 상태를 저장하지 않음
• 예시) 매번 ATM 기계를 사용할 때마다 카드와 비밀번호를 새로 입력하는 것과 같음

캐시 가능성

• 응답은 캐시 가능 여부를 명시해야 함
• 적절한 캐싱으로 성능 향상 및 서버 부하 감소
• 예시) 자주 변경되지 않는 데이터(예: 제품 이미지)는 한번 다운로드 후 재사용

계층화된 시스템 아키텍처

• 클라이언트와 서버 사이에 여러 중간 계층이 존재할 수 있음
• 클라이언트는 최종 서버와 직접 통신하는지 중간 계층과 통신하는지 알 수 없음
• 예시) 인터넷 통신에서 데이터가 여러 라우터를 거쳐 전달되지만 사용자는 알 필요 없음

REST API 작동방식

GET : 데이터 조회
POST : 새 데이터 생성
PUT / PATCH : 데이터 수정
DELETE : 데이터 삭제