API URI고민

• 리소스의 의미는 무엇일까?

  • 회원을 등록하고, 수정하고, 조회하는게 리소스가 아니다…..

  <aside> 💡 회원이라는 개념 자체가 리소스이다.

  </aside>

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

  • 회원을 등록하고 수정하고, 조회하는 것을 모두 배제

  <aside> 💡 회원이라는 리소스만 식별하면 된다. → 회원 리소스를 URI를

  </aside>

• API URI 설계

  • 리소스 식별, URI 계층구조 활용
  • 회원 목록 조회 /members
  • 회원 조회 /members/${id}. → 어떻게 분리하지?
  • 회원 등록 /members/${id} → 어떻게 분리하지?
  • 회원 수정 /members/${id} → 어떻게 분리하지?
  • 회원 삭제 /members/${id} → 어떻게 분리하지?

• 리소스와 행위를 분리

  • 가장 중요한 것은 리소스를 식별하는 것
  • URI는 리소스만 식별!!!!! (회원조회, 회원등록, 회원수정, 회원삭제)

  <aside> 💡 리소스와 해당 리소스를 대상으로 하는 행위를 분리 → 이게 중요함.

  </aside>

  • 리소스 : 회원
  • 행위 : 조회(Read), 등록(Post), 삭제(Delete), 변경(Update)
  • 리소스는 명사, 행위는 동사 (미네랄을 캐다) (회원을 등록하다)
  • 그렇다면 행위 (메서드)는 어떻게 구분???

  <aside> 💡 정의 : 자원(resource)은 url에 명시하고, 행위는 메서드로 따로 분리하여 나타낸다.

  </aside>

HTTP 메서드 (GET, POST)

주로 사용하는 HTTP 메서드의 종류

1. GET : 리소스 조회
2. POST : 요청 데이터 처리, 주로 등록에 사용
3. PUT : 리소스를 대체, 해당 리소스가 없으면 생성 (폴더에다가 파일을 넣는 느낌)
4. PATCH : 리소스 부분 변경 ( 회원의 이름을 변경 )
5. DELETE : 리소스 삭제

기타 메서드

1. HEAD : GET과 동일하지만 메시지 부분을 제회하ㅗ, 상태 줄과 헤더만 반환
2. OPTIONS : 대상 리소스에 대한 통신 가능 옵션(메서드)을 설명
3. CONNECT : 대상 자원으로 식별되는 서버에 대한 터널을 설정 - > 거의 사용 X
4. TRACE : 대상 리소스에 대한 경로를 따라 메시지 루프백 테스트를 수행 → 거의 사용 X