LEVEL 73 QUEST

RESTful API 설계 원칙

RESTful API 설계 원칙 — DevFoil 바이브코딩 Stage 16, Lv.73

REST API란 무엇인가?

웹의 공용어, REST

REST(Representational State Transfer)는 웹에서 데이터를 주고받는 표준 방식입니다. 프론트엔드와 백엔드가 소통하고, 서비스 간에 데이터를 교환하고, 외부 개발자에게 기능을 제공할 때 모두 REST API를 사용합니다.

바이브코딩으로 "REST API를 만들어줘"라고 할 때, 올바른 설계 원칙을 이해하고 있어야 좋은 코드를 얻을 수 있습니다.

이 강의에서 배우는 것:

REST의 6가지 핵심 원칙
URI 설계와 자원 명명 규칙
HTTP 메서드의 올바른 사용법
상태 코드 활용 전략
API 버전 관리

HTTP 메서드 완벽 정리

CRUD와 HTTP 메서드의 매핑

REST API에서 HTTP 메서드는 "행동"을 나타냅니다. URL은 "무엇을(자원)", 메서드는 "어떻게(행동)"를 표현합니다.

메서드	CRUD	용도	예시	멱등성
GET	Read	데이터 조회	GET /api/users/123	O
POST	Create	데이터 생성	POST /api/users	X
PUT	Update	전체 교체	PUT /api/users/123	O
PATCH	Update	일부 수정	PATCH /api/users/123	X
DELETE	Delete	데이터 삭제	DELETE /api/users/123	O

멱등성(Idempotency)이란?

같은 요청을 여러 번 보내도 결과가 동일하면 멱등하다고 합니다. GET, PUT, DELETE는 멱등하지만, POST는 멱등하지 않습니다. POST /api/users를 3번 보내면 사용자 3명이 생성됩니다.

🔒

여기까지는 미리보기입니다

RESTful API 설계 원칙
무료 가입하면 이어서 볼 수 있고, 강의를 완료할 때마다 XP와 레벨이 쌓입니다.

Google로 3초 만에 시작 →🧵 Threads로 시작 무료 공개 강의 둘러보기 (Lv.1~3)