REST API란 과연 무엇일까? 초보자를 위한 REST API 정리

안녕하세요, 개발을 처음 접하거나 웹 개발을 본격적으로 시작하는 분들이라면 자주 들었을 REST API(Representational State Transfer API)에 대해 알기 쉽게 설명해 드리겠습니다.

📌 REST API의 개념 📌

REST API란, 클라이언트와 서버 간에 데이터를 주고받기 위한 규칙을 정의한 디자인 설계 방식을 의미합니다. 웹 표준 프로토콜(주로 HTTP)을 사용해서 서로 통신하며, 자원을 관리(생성, 조회, 수정, 삭제)하는 방식이죠.
웹 개발에서 거의 필수적으로 사용되는 이 REST API의 특징과 구성 요소, 사용법 등을 차근차근 알아보겠습니다.

📌 REST API의 5가지 핵심 원칙 📌

REST API는 기본적으로 아래의 5가지 핵심 원칙을 따릅니다.

1. 클라이언트-서버 구조(Client-Server Model)
   서버는 데이터의 관리와 저장 역할만 수행하고, 클라이언트는 사용자와의 상호작용만 처리합니다. 이를 통해 서로 독립적으로 발전할 수 있어 확장성과 유지보수성이 높아집니다.
2. 무상태성(Stateless)
   서버는 클라이언트의 요청 상태를 저장하지 않으며, 클라이언트에서 요청 시 상태에 필요한 모든 정보를 포함시켜야 합니다. 각 요청은 독립적인 것으로 처리됩니다.
3. 캐시 가능성(Cacheable)
   자주 사용되는 데이터에 대해서 클라이언트나 서버 중간 단계에서 캐싱이 가능합니다. 이로써 통신 효율을 높이고 불필요한 요청을 줄여줍니다.
4. 계층적 구조(Layered System)
   서버 시스템이 여러 계층으로 나누어질 수 있으며, 클라이언트는 직접 연결된 서버 이외의 다른 내부 구조나 시스템을 알 필요가 없습니다. 이 특성은 보안과 확장성을 높이는 데 도움을 줍니다.
5. 통일된 인터페이스(Uniform Interface)
   인터페이스가 명확하며 단순하여, 모두가 쉽게 이해할 수 있도록 합니다. 리소스를 다루는 방식이 일관적이고 명확합니다.

📌 REST API의 주요 구성 📌

REST API는 크게 다음과 같은 요소로 구성됩니다.

• 자원(Resource) : URL로 표현된 데이터 또는 객체
• HTTP 메소드(Method) : 자원을 처리하는 방식 결정
  • GET : 리소스를 가져올 때(조회)
  • POST : 새 리소스를 만들 때(생성)
  • PUT : 리소스를 업데이트 할 때(수정)
  • DELETE : 리소스를 삭제할 때(삭제)
  • PATCH : 리소스 부분적 업데이트
• 표현(Representation) : 리소스 상태 표현 방법(JSON, XML, HTML 등)
• HTTP 상태 코드(Status Codes) : 요청 처리 결과를 클라이언트에 전달
  • 200 : 성공적으로 처리됨(OK)
  • 201 : 성공적으로 리소스 생성됨(Created)
  • 400 : 클라이언트 요청 오류(Bad Request)
  • 401 : 인증되지 않음(Unauthorized)
  • 403 : 접근 권한 없음(Forbidden)
  • 404 : 리소스 못 찾음(Not Found)
  • 500 : 서버 내부 오류(Internal Server Error)

📌 REST API 예제 (POST로 리소스 생성하기) 📌

쉽게 이해할 수 있게 POST 메소드의 예를 한 번 보겠습니다.
클라이언트가 새로운 상품을 추가한다고 해봅시다.

요청 예시 (Request):

POST /api/products HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "name": "새 상품",
    "price": 15000
}

응답 예시 (Response):

• 서버는 이 요청을 받으면 새 데이터를 생성하고 201 Created(생성 완료) 상태 코드와 함께 새로 생성된 데이터 정보를 결과로 전달합니다.

  HTTP/1.1 201 Created
  Content-Type: application/json
  Location: /api/products/12345
  
  {
    "id": 12345,
    "name": "새 상품",
    "price": 15000,
    "createdAt": "2024-05-08T12:34:56Z",
    "status": "success",
    "message": "새 상품이 성공적으로 생성되었습니다."
  }

이 때, 응답 헤더의 Location 항목에는 방금 생성한 데이터를 조회할 수 있는 URL 주소를 명시해 주는 것이 좋습니다. 이를 통해 클라이언트는 생성된 데이터에 추가 요청 없이 직접 접근 가능합니다.

📌 REST API를 사용하면 좋은 이유 📌

REST API를 사용하면 다음과 같은 장점이 있습니다.

• 설계가 단순하고 명확해 개발과 유지 보수가 쉽습니다.
• HTTP 표준을 따르므로 플랫폼 간 독립적이고 호환성이 뛰어납니다.
• 무상태성으로 인해 개발이 용이하고 확장성이 좋습니다.
• 캐시를 적극 활용하여 성능 향상 및 효율적인 데이터 관리가 가능합니다.

📌 마치며 📌

REST API는 웹 개발의 필수 요소로 자리 잡았고, 실제 프로젝트에서도 널리 사용되고 있습니다. 위에 언급한 원칙과 구성 요소 등을 기억하시고 잘 설계하여 효율적이고 확장 가능한 웹 서비스 및 애플리케이션을 만드는 데 활용하시기 바랍니다!
다음 글에서는 더 다양한 REST API 사용 예제와 고급 팁을 소개해 드리겠습니다 😊
읽어주셔서 감사합니다~!
📌 블로그 글 정리 핵심 키워드: REST API 개념, 핵심 원칙, 구성, 예시, 장점