[HTTP 웹 기본 지식] HTTP 메서드 - HTTP API를 만들어보자

🌱 HTTP API를 만들어보자

요구사항 및 API URI 설계

👉 회원 정보 관리 API 설계
      1. 회원 목록 조회 :  /read-member-list
      2. 회원 조회 :  /read-member-by-id
      3. 회원 등록 : /create-member
      4. 회원 수정 : /update-member
      5. 회원 삭제 : /delete-member

 

→ 요구사항 기반으로 API를 만들게 되면 위와 같이 현업에서 잘못된 API URI 설계를 한다.

 

API URI 설계 분리

👉 리소스: 회원✨✨✨
    행위: 조회, 등록, 수정, 삭제

 

→ 리소스 식별 ‼️

    API URI 설계를 할 때 리소스와 해당 리소스를 대상으로 하는 행위를 분리해야 한다.

    회원이라는 리소스만 식별하고 회원 리소스를 URI에 매핑을 하면 된다.

 

API URI 재설계

👉 회원 정보 관리 API 재설계
      1. 회원 목록 조회 :  /members
      2. 회원 조회 :  /members/{id}
      3. 회원 등록 : /members/{id}
      4. 회원 수정 : /members/{id}
      5. 회원 삭제 : /members/{id}

 

→ API URI 재설계를 했지만 행위는 구분이 되지 않는다.

→ URI 리소스만 식별해 놓으면 HTTP 메서드인 GET, POST, PUT, DELETE 이런 것들이 조회, 등록, 수정, 삭제 역할을 대신해준다.

*계층 구조상 상위를 컬렉션으로 보고 복수 단어 사용 권장(member ➡️ members)