Web programming : RESTful URL 설계 규칙

URI(Uniform Resource Identifier)와 URL(Uniform Resource Locator)

 

URI는 네트워크 상에 있는 특정 리소스를 식별하는 통합 자원 식별자(Uniform Resource Identifier)를 의미한다.

URL은 인터넷에 있는 리소스를 나타내는 통합 리소스 식별자를 의미하며, 우리가 흔히들 이야기하는 웹 상의 주소를 의미한다.

URI는 URL의 상위 개념으로 볼 수 있다.

URI는 리소스를 식별하는 식별자 역할을 하고, URL은 식별자 역할중에서도 리소스의 위치를 가리킨다.

 

예) http://www.restapi.example.com/member/1 는 리소스의 위치를 가리키는 URL이라고 할 수 있다.

 

예)  URI 의 예시로는 도서를 식별하는 국제표준도서번호(International Standard Book Number : ISBN) 를 대표적으로 생각하면 된다.

 

REST API 설계시 가장 중요한 항목은 두가지이다.

① URI 는 정보의 자원을 표현해야 한다는 점

② 자원에 대한 행위는 HTTP Method (GET, POST, PUT, PATCH, DELETE) 로 표현해야한다는 점

 

RESTful URL 설계 규칙

 

• URI는 동사❌ 명사⭕
  -> 행위를 사용하지 않는다. 행위는 HTTP Method로 표현된다.
• URI는 소문자로만 구성
• 리소스를 적을 땐 단수형 보다는 복수형 명사를 사용
• /로 계층 관계 표현
• URI 마지막 문자로 /를 포함하지 않는다. 
• _(언더바) 대신 -(하이픈)을 사용한다.
• 파일 확장자는 URI에 포함하지 않는다.
• HTTP 상태 코드를 사용하여 응답한다.

 

 

HTTP 상태 코드

 

 

https://developer.mozilla.org/ko/docs/Web/HTTP/Status

HTTP 상태 코드 - HTTP | MDN

 

보다 자세한 상태코드는 해당 사이트에서 공부 가능!!

 

참고

https://velog.io/@yoojkim/Rest-API-RESTful%ED%95%98%EA%B2%8C-URL-%EC%84%A4%EA%B3%84%ED%95%98%EA%B8%B0

https://itvillage.tistory.com/35