🌐 REST API 완전 정리 - 웹개발자가 꼭 알아야 할 핵심 개념

🧩 REST API란?

REST API는 HTTP 프로토콜 위에서 동작하는 웹 기반 데이터 통신 아키텍처 스타일입니다.
리소스(자원)를 URL로 식별하고, **HTTP 메서드(GET, POST 등)**를 통해 이를 조작합니다.

REST = REpresentational State Transfer
자원의 표현을 HTTP를 통해 전송하는 방식

---

🔧 REST API의 핵심 특징

• 프로토콜: HTTP 기반
• 형식: JSON을 주로 사용
• 자원 중심: URL로 자원을 명시적으로 표현
• 표준화된 동작: HTTP 메서드 사용

---

📦 HTTP 메서드 종류

메서드	설명
GET	리소스 조회
POST	리소스 생성
PUT	리소스 전체 수정
PATCH	리소스 일부 수정
DELETE	리소스 삭제

---

🧪 REST API 예시

메서드	URL	의미
GET	/users	사용자 목록 조회
GET	/users/1	ID가 1인 사용자 조회
POST	/users	새로운 사용자 생성
PUT	/users/1	ID가 1인 사용자 정보 전체 수정
PATCH	/users/1	ID가 1인 사용자 정보 일부 수정
DELETE	/users/1	ID가 1인 사용자 삭제

---

🔷 REST API의 6가지 설계 원칙

1. 클라이언트-서버 구조: 프론트와 백 분리
2. 무상태성(Stateless): 서버는 클라이언트 상태를 저장하지 않음
3. 캐시 가능: 응답은 명시적으로 캐시 가능
4. 계층 구조: 중간 계층(API Gateway 등) 허용
5. 일관된 인터페이스: URL + 메서드로 조작
6. 코드 온 디맨드(Optional): 서버가 코드 전달 가능 (거의 사용 안 함)

---

✅ REST API의 장점

• HTTP 표준을 활용 → 학습 비용 낮음
• JSON 사용 → 경량 통신
• 범용성 높음 → 웹, 앱, IoT 등에서 사용 가능
• 개발자 친화적 URL 구성

---

🔐 HTTP 상태 코드 자주 쓰는 것

코드	의미
200	OK: 요청 성공
201	Created: 생성 성공
400	Bad Request: 잘못된 요청
401	Unauthorized: 인증 필요
404	Not Found: 리소스 없음
500	Internal Server Error: 서버 내부 오류

---

🔧 REST API 사용 환경

사용 환경	설명
🌐 웹 애플리케이션	React, Vue 같은 프론트가 REST API 호출
📱 모바일 앱	Android, iOS 앱이 서버와 통신할 때 사용
🖥️ 데스크탑 앱	Electron, .NET 기반 앱에서도 사용됨
🤖 IoT 기기	스마트기기(CCTV, 에어컨 등)와 서버 통신 시 사용
🧩 마이크로서비스 간 통신	Spring → FastAPI 등 서버 간 API 통신에 활용됨

---

❌ REST API가 아닌 기술들

기술	설명
gRPC	고성능 바이너리 기반 API. IoT, 마이크로서비스에서 선호됨
GraphQL	클라이언트가 원하는 데이터만 요청 가능. 복잡한 쿼리 처리에 강함
WebSocket	실시간 양방향 통신 (예: 채팅, 게임 등)
SOAP	XML 기반 레거시 API (은행, 공공기관 등에서 여전히 사용)

WebSocket도 REST와는 전혀 다른 방식!

---

❓ 자주 묻는 질문 (FAQ)

질문	답변
REST API는 웹 전용인가요?	❌ 웹 중심이지만, IoT/앱 등에서도 사용됩니다.
REST는 표준인가요?	✅ 사실상 웹 API 설계에서 표준처럼 사용됩니다.
JSON만 써야 하나요?	아니요, XML 등도 가능하지만 JSON이 가장 일반적입니다.
REST API를 쓰면 좋은 이유는?	직관적이고, 확장성 있고, 대부분의 시스템과 호환됩니다.

---

🧭 마무리

• REST API는 현대 웹/앱 개발의 핵심 표준
• HTTP + 자원 중심 URL + 표준 메서드(GET, POST 등)
• JSON을 통해 가볍고 빠른 통신이 가능
• FastAPI, Spring Boot 등 다양한 프레임워크에서 쉽게 구현 가능

---

🧪 예제 코드 (FastAPI)

from fastapi import FastAPI

app = FastAPI()

@app.get("/users/{user_id}")
def get_user(user_id: int):
    return {"user_id": user_id, "name": "홍길동"}

🧪 예제 코드 (Spring Boot)

@RestController
@RequestMapping("/users")
public class UserController {
    @GetMapping("/{id}")
    public ResponseEntity<UserDto> getUser(@PathVariable Long id) {
        return ResponseEntity.ok(userService.findById(id));
    }
}