URL 생성 규칙

  1. 생성 규칙

    • 슬랙시 구분자(/)는 계층 관계를 나타내는 데 사용한다.
    • URI마지막 문자로 슬래시(/)를 포함하지 않는다.
      • URI에 포함되는 모든 글자는 리소스의 유일한 식별자로 사용되어야 한다.
      • URI가 다르다는 것은 리소스가 다르다는 것이고, 역으로 리소스가 다르면 URI도 달라져야 한다.
      • 혼동을 주지 않도록 URI 경로의 마지막에는 슬래시(/)를 사용하지 않는다.
    • 하이픈(-)은 URI가독성을 높인다.
      • URI를 쉽게 읽고 해석하기 위해, 불가피하게 긴 URI경로를 사용하게 된다면 하이픈을 사용해 가독성을 높인다.
    • URI 경로에는 소문자가 적합하다.
      • URI 경로에 대문자 사용은 피하도록 해야한다. 대소문자에 따라 다른 리소스로 인식하게 되기 때문이다. RFC 3986(URI 문법 형식)은 URI 스키마와 호스트를 제외하고는 대소문자를 구별하도록 규정하기 때문이다.
    • 파일 확장자는 포함시키지 않도록한다.
    • 참고 : https://meetup.toast.com/posts/92
  2. 적용해볼 점

    • 명사로만 표기하기 어렵다면 동사 + 명사로 표기
      • /link/product/reportUnlink : 신고된 상품을 링크 해제 하는 것인데, 한번에 알아보기 어렵다고 생각이 든다.
      • /link/product/unLinkProcess : ..코드를 기준으로 링크 해제 처리
    • product가 더 큰 범주로 가거나 혹은 순서대로 읽힐 수 있도록 규칙을 정하면 좋을것 같다.