[HTTP] 4-1. HTTP API

'모든 개발자를 위한 HTTP 웹 기본 지식' 강의를 보고 정리하였습니다.

 

우리가 회원 정보 관리에 대한 API URI를 설계해야 한다고 가정해 봅시다.

 

회원 기능

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

이게 과연 좋은 URI 설계일까요 ?

URI를 설계할 때는 '리소스'에 집중해야 합니다.

 

리소스가 뭔데 ? 🧐

'사과를 가져와라'라는 문장에서 리소스는 '사과'입니다. ('가져와라'는 행위에 해당)

따라서 회원 등록, 회원 조회, 회원 수정 등에서의 리소스는 '회원'이 됩니다.

 

리소스에 집중하라고 했으니 .. 이렇게 설계하면 될까요 ?

• 회원 등록: /members/{id}
• 회원 조회: /members/{id}
• 회원 수정: /members/{id}
• 회원 삭제: /members/{id}

위 URI들을 봤을 때, 어떤 게 등록이고 어떤 게 조회인지 구분할 수 없다는 문제점이 발생합니다. 여기서 행위를 구분해 주는 것이 바로 'HTTP 메서드'입니다.

 

HTTP 메서드

HTTP 메서드는 서버가 수행해야 할 행위를 지정해 주는 역할을 합니다.

 

HTTP 주요 메서드 종류

• GET: 리소스 조회
• POST: 요청 데이터 처리, 주로 등록에 사용
• PUT: 리소스를 대체, 해당 리소스가 없으면 생성
• PATCH: 리소스 부분 변경
• DELETE: 리소스 삭제

 

다음 포스팅에서는 HTTP 메서드들을 본격적으로 정리해 보도록 하겠습니다 😊