REST API란 – GET, POST, PUT, DELETE 완전 정리

목차

1. API를 배웠는데 REST는 또 뭔가?
2. REST API의 정의
3. REST의 핵심 원칙
4. HTTP 메서드 완전 정리 – GET, POST, PUT, DELETE
5. REST API URL 설계 방식
6. REST API 요청과 응답의 구조
7. REST API가 아닌 것들 – SOAP와의 차이
8. 정리 및 다음 단계

1. API를 배웠는데 REST는 또 뭔가?

API가 "서로 다른 소프트웨어가 소통하는 창구"라는 것을 배웠습니다. 그런데 개발 관련 글을 읽다 보면 단순히 "API"가 아니라 "REST API", "RESTful API"라는 표현을 더 자주 만나게 됩니다.

REST는 API를 만드는 여러 방식 중 하나입니다. 현재 웹 서비스에서 가장 널리 사용되는 API 설계 방식이기 때문에, 웹 개발을 배운다면 REST API 개념은 반드시 알아야 합니다.

2. REST API의 정의

**REST(Representational State Transfer)**는 웹의 장점을 최대한 활용할 수 있도록 로이 필딩이 2000년에 제안한 API 설계 원칙입니다. REST 원칙을 따르는 API를 REST API 또는 RESTful API라고 부릅니다.

REST API는 HTTP 프로토콜을 기반으로 동작합니다. URL로 어떤 데이터를 다룰지 표현하고, HTTP 메서드(GET, POST, PUT, DELETE 등)로 어떤 행동을 할지 표현합니다.

3. REST의 핵심 원칙

REST API가 따르는 주요 원칙을 알아두면 왜 이런 방식으로 설계하는지 이해하는 데 도움이 됩니다.

균일한 인터페이스: URL과 HTTP 메서드를 일관된 방식으로 사용합니다. 누가 만들어도 비슷한 구조를 갖습니다.

무상태(Stateless): 각 요청은 독립적이며, 서버는 이전 요청의 상태를 기억하지 않습니다. 필요한 정보는 매 요청마다 함께 전달해야 합니다.

계층 구조: 클라이언트는 자신이 서버와 직접 통신하는지, 중간 서버(프록시, 로드밸런서)를 거치는지 알 필요가 없습니다.

캐시 가능: 응답 데이터는 캐시할 수 있어야 하며, 이를 통해 성능을 높일 수 있습니다.

4. HTTP 메서드 완전 정리 – GET, POST, PUT, DELETE

REST API에서 가장 중요한 개념이 바로 HTTP 메서드입니다. 같은 URL이라도 어떤 메서드를 사용하느냐에 따라 완전히 다른 동작을 합니다.

메서드역할비유

GET	데이터 조회	도서관에서 책을 빌려보기
POST	데이터 생성	도서관에 새 책 등록하기
PUT	데이터 전체 수정	책의 내용 전체를 새 버전으로 교체하기
PATCH	데이터 일부 수정	책의 특정 페이지만 수정하기
DELETE	데이터 삭제	책을 도서관에서 폐기하기

GET – 데이터를 가져올 때 서버에서 데이터를 읽어오는 요청입니다. 데이터를 변경하지 않기 때문에 몇 번을 호출해도 결과가 같습니다. 브라우저에서 URL을 입력하면 기본적으로 GET 요청이 발생합니다.

POST – 새 데이터를 만들 때 서버에 새로운 데이터를 생성하는 요청입니다. 회원가입, 게시글 작성, 주문 생성 등이 해당됩니다. 같은 요청을 반복하면 데이터가 중복으로 생성될 수 있습니다.

PUT – 데이터를 수정할 때 기존 데이터를 새로운 내용으로 완전히 교체하는 요청입니다. 수정하지 않은 필드도 모두 포함해서 전송해야 합니다.

PATCH – 데이터 일부만 수정할 때 기존 데이터 중 일부 필드만 수정하는 요청입니다. 변경할 필드만 보내면 됩니다. PUT과 혼용되는 경우도 많습니다.

DELETE – 데이터를 삭제할 때 서버의 특정 데이터를 삭제하는 요청입니다. 게시글 삭제, 계정 탈퇴 등이 해당됩니다.

5. REST API URL 설계 방식

REST API URL은 명사로 리소스(자원)를 표현하고, HTTP 메서드로 행동을 표현합니다.

예를 들어 블로그 게시글을 관리하는 API URL을 설계한다면 아래와 같이 구성합니다.

전체 게시글 목록을 조회할 때는 GET 방식으로 /posts에 요청합니다. 특정 게시글을 조회할 때는 GET 방식으로 /posts/1처럼 ID를 URL에 포함합니다. 새 게시글을 작성할 때는 POST 방식으로 /posts에 요청합니다. 게시글을 수정할 때는 PUT 방식으로 /posts/1에 요청합니다. 게시글을 삭제할 때는 DELETE 방식으로 /posts/1에 요청합니다.

REST API URL 설계 시 지켜야 할 규칙이 몇 가지 있습니다. URL에는 동사 대신 명사를 사용합니다. /getPosts 대신 /posts처럼 작성합니다. 소문자를 사용하고 단어 구분에는 하이픈(-)을 사용합니다. 마지막 슬래시(/)는 붙이지 않습니다.

6. REST API 요청과 응답의 구조

REST API는 주로 JSON 형식으로 데이터를 주고받습니다.

요청 예시로, 새 사용자를 생성하는 POST 요청의 본문(body)은 아래와 같은 JSON 형태입니다.

{
  "name": "홍길동",
  "email": "hong@example.com",
  "password": "1234"
}

응답 예시로, 서버는 처리 결과를 HTTP 상태 코드와 함께 JSON으로 돌려줍니다.

 

{
  "id": 1,
  "name": "홍길동",
  "email": "hong@example.com",
  "createdAt": "2026-05-01T09:00:00Z"
}

HTTP 상태 코드로 요청 결과를 알 수 있습니다. 200은 성공, 201은 생성 성공, 400은 잘못된 요청, 401은 인증 필요, 404는 리소스 없음, 500은 서버 오류를 의미합니다.

7. REST API가 아닌 것들 – SOAP와의 차이

REST 이전에는 **SOAP(Simple Object Access Protocol)**이라는 방식이 많이 사용됐습니다. 두 방식을 간단히 비교하면 다음과 같습니다.

구분REST APISOAP

데이터 형식	JSON (주로)	XML
속도	빠름	느림
복잡도	간단	복잡
현재 사용	대부분의 웹 서비스	금융, 공공기관 일부

현재는 대부분의 웹·앱 서비스가 REST API를 사용하며, SOAP는 일부 금융기관이나 레거시 시스템에서 유지되고 있습니다.

8. 정리 및 다음 단계

오늘 배운 핵심을 정리합니다.

• REST API는 HTTP를 기반으로 URL로 리소스를 표현하고 메서드로 행동을 표현하는 API 설계 방식입니다.
• GET은 조회, POST는 생성, PUT은 전체 수정, PATCH는 부분 수정, DELETE는 삭제를 담당합니다.
• URL은 명사로 설계하고, 행동은 HTTP 메서드로 구분합니다.
• REST API는 주로 JSON 형식으로 데이터를 주고받습니다.

다음 글에서는 JSON이 무엇인지, 데이터를 어떻게 주고받는지 알아보겠습니다.