HTTP 웹 기본 지식 : HTTP 메서드

이 글의 코드와 정보들은 강의를 들으며 정리한 내용을 토대로 작성하였습니다.

API URI 설계

예를 들면 요구사항에서 회원 정보 관리 API를 만드는 내용이 적혀져 있다.
이런 경우 좋은 URI 설계는 리소스를 식별하는 것이다. 여기서 리소스는 회원을 의미한다.
- 회원 목록 조회 /members
- 회원 조회 /members/{id}
- 회원 등록 /members/{id}
- 회원 수정 /members/{id}
- 회원 삭제 /members/{id}
URI는 리소스만 식별하므로 리소스와 해당 리소스를 대상으로 하는 행위를 분리시킨다. 여기서 행위는 조회, 등록, 수정, 삭제을 의미한다.
행위(메서드)는 GET, POST, PUT, PATCH, DELETE 로 구분한다.

GET /search?q=hello&hl=ko HTTP/1.1 
Host: www.google.com

POST /members HTTP/1.1 
Content-Type: application/json
{
"username": "hello", "age": 20
}

[1] 새 리소스를 생성(등록)
- 서버가 아직 식별하지 않는 새 리소스를 생성
[2] 요청 데이터를 처리
- 단순히 데이터를 생성하거나 변경하는 것을 넘어서 프로세스를 처리해야 하는 경우
- 예시) 주문에서 결제완료 -> 배달시작 -> 배달완료 처럼 프로세스의 상태를 변경되는 경우
- POST의 결과로 새로운 리소스가 생성되지 않을 수 있다.
- 예시) POST /orders/{orderId}/start-delivery(컨트롤 URL)
[3] 다른 메서드로 처리하기 애매한 경우
- 만약 HTTP에서 PATCH를 받아들이지 못하는 경우 POST를 쓰면 된다.

PUT /members/100 HTTP/1.1 
Content-Type: application/json
{
"username": "hello", "age": 20
}

리소스를 완전히 대체한다. 리소스가 있으면 대체, 없으면 생성한다. (쉽게 말해 덮어버린다는 의미다)
클라이언트가 리소스를 식별하고 URI를 지정한다. => /members/100
- POST의 경우 리소스를 식별하지 못한다. => /members

PATCH /members/100 HTTP/1.1 
Content-Type: application/json
{
"age": 50
}

DELETE /members/100 HTTP/1.1 
Host: localhost:8080

호출해도 리소스를 변경하지 않는다. 해당 리소스만 고려하기 때문에 로그가 쌓여서 장애가 발생하는 부분까지 고려하지 않는다.
- 안전에 해당하는 메서드 : GET

몇번을 호출하든 결과가 똑같다. 외부 요인으로 중간에 리소스가 변경되는 것 까지는 고려하지 않는다.
- 멱등에 해당하는 메서드 : GET, PUT, DELETE, HEAD
활용) 자동 복구 메커니즘

응답 결과 리소스를 캐시해서 실제로 사용하는 메서드는 GET, HEAD 가 있다.
- 캐시가능에 해당하는 메서드 : GET, HEAD, POST, PATCH