정리하고 기록하며 성장하는

HTTP API 만들기 본문

HTTP/HTTP 메서드

HTTP API 만들기

개발하는묭이 2021. 12. 27. 22:17

요구사항 

회원 정보 관리 API 만들기

 

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

API URL 설계

URL (Uniform Resource Identifier)

 

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

이렇게 설계 하는 것이 좋은 URI 설계 일까?

리소스를 식별하는 것이 좋은 URI 설계 이다

리소스 - 개념 자체를 의미한다

예) 미네랄을 캐라 -> 미네랄이 리소스이다

     회원을 조회 하라 -> 회원이 리소스이다

 

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

  • 회원을 등록 , 수정 , 조회 하는 행위에 해당하는 것을 모두 배제한다
  • 회원이라는 리소스만 식별하면 된다

API URI 설계

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

문제점

리소스는 같이만 행위는 다르다

조회 , 등록 , 수정 , 삭제 라는 행위를 어떻게 분리할 것인가

즉 리소스와 해당 리소스를 대상으로 하는 행위를 분리해야 한다

리소스 : 회원

행위 : 조회 , 등록  , 삭제 , 변경

리소스는 명사 , 행위는 동사

리소스의 행위(메서드)를 어떻게 구분할 것인가

 

 

'HTTP > HTTP 메서드' 카테고리의 다른 글

HTTP 메서드 - GET , POST  (0) 2021.12.27