🛣️ REST URL 설계 가이드 | 경로를 어떻게 나눌까?

기본 경로 (선택)

컬렉션 이름

서브 컬렉션 이름 (선택)

식별자 자리 표기

컬렉션 조회 (GET)

컬렉션에 추가 (POST)

단건 조회 (GET)

단건 전체 교체 (PUT)

단건 일부 수정 (PATCH)

단건 삭제 (DELETE)

규격이 정한 것과 관행인 것

내용	구분
경로는 대소문자를 구분한다 (스킴과 호스트는 구분하지 않는다)	규격
끝 슬래시가 있는 주소와 없는 주소는 서로 다른 주소다	규격
질의 문자열은 경로와 별개 부분이다 (순서를 어떻게 다룰지는 규격이 정하지 않아 서버마다 다름)	규격 (RFC 3986 §3.4)
컬렉션 이름을 복수형으로 쓴다	관행
소문자와 하이픈만 쓴다	관행
경로에 동사를 넣지 않고 행위는 메서드로 나눈다	관행
계층을 두 단계 안쪽으로 유지한다	관행

이 도구는 점수나 등급을 내지 않습니다. 관행과 다른 점은 세어서 알려 주기만 하고, 어느 쪽이 옳다고 판정하지 않습니다. 버저닝 방식 선택, 상태 코드 선택, 페이지네이션 방식 선택은 각각 다른 도구의 몫입니다.

도구 설명

컬렉션 이름과 서브 컬렉션 이름, 쓸 메서드를 고르면 실제로 생기는 경로와 메서드 쌍을 표로 전개해 줍니다. 컬렉션 경로와 단건 경로가 각각 어떤 메서드를 받는지, 그 메서드가 무엇을 하는지 한 화면에서 볼 수 있어, 라우팅 표를 짜거나 문서의 목차를 만들 때 빠진 조합을 바로 알아볼 수 있습니다. 식별자 자리 표기는 OpenAPI 형태와 라우터 형태 중에서 고를 수 있습니다.

이 도구는 점수나 등급을 내지 않습니다. 대신 2026년 10월 기준 URI 규격이 정한 내용과 업계 관행을 나눠서 보여 줍니다. 경로가 대소문자를 구분하는 것과 끝 슬래시가 다른 주소를 가리키는 것은 규격이지만, 컬렉션 이름을 복수형으로 쓰고 소문자와 하이픈만 쓰는 것은 관행입니다. 관행과 다른 점이 보이면 세어서 알려 주기만 하고 어느 쪽이 옳다고 판정하지 않습니다.

버저닝 방식을 고르는 일, 상황별 상태 코드를 고르는 일, 페이지네이션 방식을 고르는 일은 각각 다른 도구가 다룹니다. 이 도구는 인증 설계, 요청·응답 본문 스키마, 속도 제한 설계도 다루지 않습니다.

자주 묻는 질문

컬렉션 이름을 복수형으로 써야 하나요?

규격이 정한 규칙은 아니고 널리 퍼진 관행입니다. 복수형을 쓰면 목록과 단건이 같은 이름 아래 자연스럽게 놓여 읽기 쉬워집니다. 팀 안에서 한 가지 방식으로 일관되게 쓰는 것이 어느 쪽을 고르는지보다 중요합니다.

중첩 경로는 몇 단계까지 두는 게 좋나요?

정해진 상한은 없습니다. 다만 상위 식별자가 없어도 하위 항목이 유일하게 가리켜진다면 중첩 대신 자체 컬렉션으로 내놓는 편이 경로가 짧아지고 캐시 키도 단순해집니다. 상위가 있어야 뜻이 생기는 관계에만 중첩을 남기세요.

이 도구가 하지 않는 것은 무엇인가요?

점수·등급 산정, 버저닝 방식 선택, 상태 코드 선택, 페이지네이션 방식 선택은 하지 않습니다. 경로와 메서드 쌍을 전개하고 규격과 관행을 구분해 보여 줍니다.

🛣️REST 리소스 URL 설계 가이드

규격이 정한 것과 관행인 것

관련된 도구

HTTP 메서드 선택 가이드

REST API 네이밍 검사기

도구 설명

자주 묻는 질문

규격이 정한 것과 관행인 것

관련된 도구

HTTP 메서드 선택 가이드

REST API 네이밍 검사기

도구 설명

자주 묻는 질문

같은 카테고리 도구