모든 개발자를 위한 HTTP 웹 기본 지식

Ch04. HTTP 메서드 - HTTP API를 만들어보자

webmaster 2022. 2. 25. 11:56
728x90
  • 요구사항 
    • 회원 정보 관리 API를 만들어라.
      • 회원 목록 조회 /read-member-list
      • 회원 조회 /read-member-by-id
      • 회원 등록 /create-member
      • 회원 수정 /update-member
      • 회원 삭제 /delete-member
    • 이것은 좋은 URI 설계일까?
      • URI는 리소스 식별이 가장 중요하다.
      •  리소스의 의미는 뭘까?
        • 회원을 등록하고 수정하고 조회하는 게 리소스가 아니다! 
          • 예) 미네랄을 캐라 -> 미네랄이 리소스
        • 회원이라는 개념 자체가 바로 리소스다.
      • 리소스를 어떻게 식별하는게 좋을까?
        • 회원을 등록하고 수정하고 조회하는 것을 모두 배제
        • 회원이라는 리소스만 식별하면 된다. -> 회원 리소스를 URI에 매핑
    • 리소스 식별, URI 계층 구조 활용
      • 회원 목록 조회 /members
      • 회원 조회 /members/{id}   -> 어떻게 구분하지?
      • 회원 등록 /members/{id}   -> 어떻게 구분하지? 
      • 회원 수정 /members/{id}   -> 어떻게 구분하지?
      • 회원 삭제 /members/{id}   -> 어떻게 구분하지?
      • 참고: 계층 구조상 상위를 컬렉션으로 보고 복수 단어 사용 권장(member -> members)
    • URI는 리소스만 식별!
    • 리소스와 해당 리소스를 대상으로 하는 행위을 분리
      •  리소스: 회원
      •  행위: 조회, 등록, 삭제, 변경
    • 리소스는 명사, 행위는 동사 (미네랄을 캐라)
    • 행위(메서드)는 어떻게 구분?
728x90