참고하면 좋은 URL 설계 개념

문서(document)

• 단일 개념(파일 하나, 객체 인스턴스, 데이터베이스 row)
• 예) /members/100, /files/star.jpg 컬렉션(collection)

컬렉션(collection) - 주로 사용

• 서버가 관리하는 리소스
• 디렉터리 서버가 리소스의 URI를 생성하고 관리
• 예) /members

스토어(store)

• 클라이언트가 관리하는 자원
• 저장소 클라이언트가 리소스의 URI를 알고 관리
• 예) /files

컨트롤러(controller), 컨트롤 URI

• 문서, 컬렉션, 스토어로 해결하기 어려운 추가 프로세스 실행
• 동사를 직접 사용
• 예) /members/{id}/delete

리소스를 먼저 생각하자! 만약 이걸로 해결이 안 된다면 컨트롤 URI를 사용하자!

문서, 컬랙션을 적용 -> 안되면 컨트롤 URI 사용!

 

참고

https://restfulapi.net/resource-naming/

REST Resource Naming Guide