백엔드 API 설계 스킬

범용 백엔드 API 설계 원칙 및 구현 패턴 가이드.

RESTful 설계 원칙

리소스 명명 규칙

# 컬렉션: 복수 명사
GET    /api/v1/users           # 목록 조회
POST   /api/v1/users           # 생성

# 단일 리소스: 식별자 포함
GET    /api/v1/users/{id}      # 단건 조회
PUT    /api/v1/users/{id}      # 전체 수정
PATCH  /api/v1/users/{id}      # 부분 수정
DELETE /api/v1/users/{id}      # 삭제