HTTP method
- HTTP API 를 만들어보자
- HTTP 메서드 - GET, POST
- HTTP 메서드 - PUT, PATCH, DELETE
- HTTP 메서드의 속성
요구사항
회원 정보 관리 API를 만들어라
URI 설계의 오류
- 회원 목록 조회
/read-member-list
- 회원 조회
/read-member-by-id
- 회원 등록
/create-member
- 회원 수정
/update-member
- 회원 삭제
/delete-member
API URI 설계
URI (Uniform Resource Identifier)
- 가장 중요한 것은 리소스 식별
- 리소스는 회원이라는 개념 자체가 리소스 ✅
- 회원을 등록하고 수정하고 조회하는건 리소스가 아니다. ❌
- 리소스 식별
- 회원을 등록하고 수정하고 조회하는 것을 모두 배제 ❌
- 회원이라는 리소스만 식별 → 회원 리소스를 URI 에 매핑 ✅
리소스 식별
URI 계층 구조 활용
계층 구조 활용의 오류
- 회원 목록 조회 /members
- 회원 조회 /members/{id} (구분 불가)
- 회원 등록 /members/{id} (구분 불가)
- 회원 수정 /members/{id} (구분 불가)
- 회원 삭제 /members/{id} (구분 불가)
- 참고 : 계층 구조상 상위를 컬렉션으로 보고 복수 단어 사용 권장 (member → members)
리소스와 행위를 분리
- URI 는 리소스만 식별
- 리소스와 해당 리소스를 대상으로 하는 행위를 분리
- 리소스 : 회원
- 행위 : 조회, 등록, 삭제, 변경
- 리소스는 명사, 행위는 동사
HTTP 메서드 종류
- GET : 리소스 조회
- POST : 요청 데이터 처리, 주로 등록에 사용
- PUT : 리소스를 대체, 해당 리소스가 없으면 생성
- PATCH : 리소스 부분 변경
- DELETE : 리소스 삭제
- HEAD : GET 과 동일하지만 메시지 부분을 제외하고, 상태 줄과 헤더만 반환
- OPTIONS : 대상 리소스에 대한 통신 가능 옵션 (메서드) 을 설명 (주로 CORS 에서 사용)