1. URI VS URI

URL은 URI 의 하위 개념

URI

• 인터넷에 특정 자원을 나타내는 주소 값

• 해당 값은 유일하지만, 응답은 달리질 수 있음

• ex. http://www.ssamz.com:80/BoardWeb/board/login.html 중 BoardWeb/board/login.html 여기 부분이 URI

URL

• 인터넷 상에서 자원, 특정 파일이 어디에 위치하는 지 식별하는 주소

• ex. http://www.ssamz.com:80/BoardWeb/board/login.html 전체

URI 설계 원칙 (RFC-3986)

• 슬래시 구분자 / → 계층 관계

• URI 마지막 문자로 / 는 포함하지 않음

• 하이픈 - → URI 가독성 높임

• 밑줄 _ → 사용 안함

• UIR 경로에는 소문자가 적합
  
  

• 파일 확장자는 URI에 포함하지 않음

• 프로그래밍 언어에 의존적인 확장자를 사용하지 않음

• 구현에 의존적인 경로를 사용하지 않음

• 세션 ID를 포함하지 않음

• 프로그래밍 언어의 Method 명을 이용하지 않음

• 명사에 단수형 보다는 복수형 사용, 컬렉션에 대한 표현은 복수로 사용

• 컨트롤러 이름으로는 동사나 동사구를 사용

• 경로부분 중 변하는 부분은 유일한 값으로 대체

• CRUP 기능을 나타내는 것은 URI에 사용하지 않음
  
  

• URI Query Parameter 디자인 : URI 쿼리 부분으로 컬렉션 결과에 대해 필터링 가능

• URI 쿼리는 컬렉션의 결과를 페이지로 구분하여 나타내는데 사용

• API에 있어 서브 도메인은 일관성 있게 사용

• 클라이언트 개발자 포탈 서브 도메인은 일관성 있게 만듦

원칙이 매우 많지만, 생산성/작업속도 향상을 위해 많이 익혀두자!