API URI 고민
URI(Uniform Resource Identifier)
- 리소스의 의미
- 회원을 등록하고 수정하고 조회하는게 리소스가 아닙니다.
- 예) 미네랄을 캐라 -> 미네랄이 리소스
회원이라는 개념 자체가 바로 리소스입니다.
- 리소스 식별 방법
- 회원을 등록하고 수정하고 조회하는 것을 모두 배제
회원이라는 리소스만 식별하면 됩니다. -> 회원 리소스를 URI에 매핑
API URI 설계
리소스 식별, URI 계층 구조 활용
- 회원 목록 조회 /members
- 회원 조회 /members/{id}
- 회원 등록 /members/{id}
- 회원 수정 /members/{id}
- 회원 삭제 /members/{id}
- 참고: 계층 구조상 상위를 컬렉션으로 보고 복수단어 사용 권장(member -> members)
리소스와 행위를 분리
가장 중요한 것은 리소스를 식별하는 것
URI는 리소스만 식별
리소스
와 해당 리소스를 대상으로 하는행위
를 분리- 리소스: 회원
- 행위: 조회, 등록, 삭제, 변경
- 리소스는 명사, 행위는 동사 (미네랄을 캐라)
참조
'Web' 카테고리의 다른 글
[HTTP 웹 기본 지식] HTTP 메서드 - PUT, PATCH, DELETE (0) | 2021.09.22 |
---|---|
[HTTP 웹 기본 지식] HTTP 메서드 - GET, POST (0) | 2021.09.22 |
[HTTP 웹 기본 지식] HTTP 메시지 (0) | 2021.09.22 |
[HTTP 웹 기본 지식] 비 연결성(connectionless) (0) | 2021.09.22 |
[HTTP 웹 기본 지식] Stateful, Stateless (0) | 2021.09.22 |
댓글