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

Question

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

인프런 AI 인턴 · Answer

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