
REST API URI 설계 가이드
·
개발 - 정보/Web
[REST 설계] URI 식별자(Identifier) 설계 가이드1) 원칙 요약리소스는 명사, 복수형: 동사가 아니라 무엇을 다루는지 드러내기GET /users, POST /orders계층 구조는 관계를 표현: 포함·소유 관계만 중첩GET /users/{userId}/orders/{orderId}조작은 HTTP 메서드에 맡기기: URI에 동사 넣지 않기❌ POST /createUser → ✅ POST /users일관성 유지: 전 서비스 공통 네이밍·구분자·규칙 강제불변·불투명 ID 선호: 내부 키 노출 지양, UUID/ULID 등 사용클라이언트 제어용 파라미터는 쿼리스트링: 필터링/정렬/페이지네이션표현/포맷은 헤더 우선: Accept, Content-Type로 컨트롤2) 네이밍 컨벤션케밥 케이스(keba..