Skip to content

Latest commit

 

History

History
36 lines (26 loc) · 1.32 KB

httpapi.md

File metadata and controls

36 lines (26 loc) · 1.32 KB

HTTP API를 만들어보자

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

가장 중요한 것은 리소스 식별

리소스의 의미

  • 회원을 등록하고 수정하고 조회하는게 리소스가 아니다.
    • 예 ) 미네랄을 캐라 -> 미네랄이 리소스
    • 회원이라는 개념 자체가 바로 리소스다
  • 리소스를 어떻게 식별하는게 좋을까 ?
    • 회원을 등록하고 수정하고 조회하는 것을 모두 배제
    • 회원이라는 리소스만 식별하면 된다 -> 회원 리소스를 URI에 매핑

API URI 설계

URI(Uniform Resource Identifier)
리소스 식별 , URI 계층 구조 활용

  • 회원 목록 조회 / members
  • 회원 조회 /members/{id} -> 어떻게 구분?
  • 회원 등록 /members/{id} -> 어떻게 구분?
  • 회원 수정 /members/{id} -> 어떻게 구분?
  • 회원 삭제 /members/{id} -> 어떻게 구분?
  • 참고 : 계층 구조상 상위를 컬렉션으로 보고 복수단어 사용을 권장(member >> members)

리소스와 행위를 분리

가장 중요한 것은 리소스를 식별하는 것

  • URI 는 리소스만 식별!
  • 리소스와 해당 리소스를 대상으로 하는 행위를 분리
    • 리소스는 명사, 행위는 동사
    • 행위(메서드)는 어떻게 구분할까?

HTTP 메서드편에서 다루겠다.