RESTful 한 URL
① URI는 행위에 대한 표현이 아닌 리소스 표현하는데 중점을 두어야 한다.
•
리소스명은 동사보다는 명사를 사용한다.
// REST를 제대로 적용하지 않은 URI 예시
GET /members/delete/1
Java
복사
② 리소스에 대한 행위는 HTTP Method로 표현한다.
•
GET, POST, PUT, DELETE 등
// REST 적용 예시 1
GET /members/delete/1 (X)
DELETE /members/1 (O)
Java
복사
③ 슬래시 구분자(/)는 계층 관계를 나타내는데 사용한다.
④ URI 마지막 문자로 슬래시(/)를 포함하지 않는다.
⑤언더바(_)는 사용하지 않는다.
•
보기 어렵기 때문에 가독성 문제가 발생한다.
•
대신 하이픈(-) 사용한다.
⑥ 하이픈(-)은 URI 가독성을 높이는데 사용할 수 있다.
•
불가피하게 긴 URI 경로에 사용해서 가독성을 높인다
⑦ 소문자를 사용한다.
•
대소문자에 따라 다른 리소스로 인식하기 때문이다.
⑧ 파일 확장자는 포함시키지 않는다
•
Accept header를 사용한다.
…. /user/item