인프런에서 [모든 개발자를 위한 HTTP 웹 기본 지식]을 수강하며 학습한 내용을 정리합니다. 수업 자료 PDF는 비공개로 관리하고 있습니다. → [email protected]으로 요청하세요!

💡HTTP API 만들어보기

요구사항 : 회원 정보 관리 API를 만들어라.

• 회원 목록 조회
• 회원 조회
• 회원 등록
• 회원 수정
• 회원 삭제

과연 아래의 URI는 좋은 설계일까?

• 회원 목록 조회 : /read-member-list
• 회원 조회 : /read-member-by-id
• 회원 등록 : /create-member
• 회원 수정 : /update-member
• 회원 삭제 : /delete-member

URI 설계 시 가장 중요한 것은 리소스 식별이다!

리소스의 의미는?

• 미내랄을 캐라 → 미네랄이 리소스
• 회원의라는 개념 자체가 바로 리소스다.

리소스를 어떻게 식별하는게 좋을까?

• 회원을 등록하고 수정하고 조회하는 것을 모두 배제
• 회원이라는 리소스만 식별하면 된다 → 회원 리소스를 URI에 매핑

URI 계층 구조를 활용해 API URI를 설계해보자!

이때, 계층 구조상 상위를 컬렉션으로 보고, 복수단어 사용을 권장한다!

• 회원 목록 조회 : /members
• 회원 조회 : /members/{id}
• 회원 등록 : /members/{id}
• 회원 수정 : /members/{id}
• 회원 삭제 : /members/{id}

→ 이때, URI가 모두 동일하다! 이를 어떻게 구분하지?