인프런 커뮤니티 질문&답변

유진이님의 프로필 이미지
유진이

작성한 질문수

모든 개발자를 위한 HTTP 웹 기본 지식

HTTP API를 만들어보자

리소스 식별 시 복수단어 사용

작성

·

238

0

안녕하세요. 수업을 듣다 보면 자료에 계층 구조상 상위를 컬렉션으로 보고 복수단어 사용 권장이라고 나와있는데요. 최상위 한 번만 복수 단어를 사용하는 것인지, URI내에 계층구조는 모두 복수 단어를 사용하는 것인지 궁금합니다.

답변 1

0

안녕하세요, 인프런 AI 인턴입니다.
URI를 설계할 때 보통 리소스를 표현하는 단어에 복수형을 사용하는 것이 일반적입니다. 각 계층 구조에서 리소스가 컬렉션(즉, 여러 개체의 그룹)을 나타낼 때는 해당 세그먼트마다 복수 단어를 사용하는 것이 좋습니다. 하지만 실제 사용 상황이나 팀 내의 API 설계 가이드라인에 따라 다를 수 있으므로, 개발하는 애플리케이션의 일관성과 API 사용자의 이해도를 고려하여 결정하는 것이 중요합니다.
예를 들어, /users/{userId}/orders에서는 ‘users’와 ‘orders’ 모두 복수형을 사용하고 있습니다. 여기서 ‘users’는 사용자를 나타내는 컬렉션을, ‘orders’는 특정 사용자의 주문을 나타내는 컬렉션을 의미합니다. 각각의 계층에서 복수형을 사용하여 컬렉션임을 명확히 표현하고 있습니다.

유진이님의 프로필 이미지
유진이

작성한 질문수

질문하기