1. HTTP API

다음과 같이 회원 정보를 관리하는 API를 만든다고 가정해봅시다.

2. URI와 리소스

이 때 API가 가지는 기능들을 구분하기 위해 URI를 설계해야 합니다. 어떻게 하는 것이 좋을까요? 우선 한 가지 염두할 것은 URI는 리소스를 식별하는 용도로 사용되어야 한다는 것 입니다. 회원을 등록하는 것이 리소스가 아니라 회원 그 자체가 리소스입니다. 따라서 URI에는 회원이라는 리소스 자체만 포함되어야 합니다. 여기서 문제는

서로 다른 기능들을 URI만으로 구별할 수 가 없다는 것 입니다. 이러한 문제를 해결해주는 것이 바로 HTTP 메소드입니다.

3. HTTP 메소드

1) HTTP 메소드의 종류

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

a) GET

  • 리소스 조회
  • 서버에 전달하고 싶은 데이터를 query를 통해 전달

b) POST

  • 요청 데이터 처리 (단순히 데이터를 생성하거나, 변경하는 것 뿐 아니라 프로세스를 처리하는데도 사용)
  • 메시지 바디를 통해 서버로 요청 데이터 전달
  • 서버는 요청 데이터 처리
  • 리소스 URI 에 POST 요청이 오면 요청 데이터를 어떻게 처리할지 리소스마다 따로 정해야함

c) PUT

d) PATCH

e) DELETE

Tags:

Categories:

Updated: