CRUD와 HTTP Status Code

Method는 주어진 리소스에 대해 서버가 수행하길 원하는 행동으로서, 서버가 수행해야 하는 동작을 지정한다.

HTTP 주요 Method에는 GET, POST, PUT, PATCH, DELETE가 있고, 이러한 기본적인 데이터 처리 기능을 CRUD라고 한다.

CRUD (Create, Read, Update, Delete)

1. GET

• 리소스 조회 (Read)
• 데이터를 읽거나 검색할 때 사용되는 메소드

2. POST

• 요청된 자원 생성 (Create)
• 요청 시 Body 값과 Content-Type 값을 작성하여 서버로 요청 데이터 전달

POST /members HTTP/1.1
Content-Type: application/json

{
    "username": "ro",
    "age": 23
}

3. PUT

• 요청된 자원 수정 (Update)
• 요청 시 Body 값과 Content-Type 값을 작성하여 서버로 요청 데이터 전달
  • 기존에 있는 리소스의 경우 업데이트
  • 리소스가 없다면 새롭게 생성
• 대상 리소스가 무엇인지 정확하게 알고 URI를 지정하는 것이 중요
• 자원 전체 갱신

4. PATCH

• 요청된 자원 수정 (Update)
• 해당 자원 일부 교체 - PUT과의 차이점

5. DELETE

• 요청된 자원 삭제 (Delete)

HTTP Status Code

HTTP 상태 코드는 서버로 보낸 요청 상태를 나타내는 코드이다.

서버로 보내진 작업의 수행 상태를 알려줄 수 있도록 표준에 맞춘 일종의 약속이다.

HTTP 상태 코드를 사용하면 에러 종류에 대한 커뮤니케이션이 편리하고, HTTP 요청이 잘 이루어졌는지의 여부와 에러가 발생했다면 원인이 무엇인지 파악할 수 있다는 장점이 있다.

 

HTTP 상태 코드는 3자리 숫자로 구성되며 첫째 자리는 1에서 5까지 존재한다.

이 중 첫째 자리 4와 5는 정상 상태가 아닌 경우이다.

 

• 1XX (Informational): 요청이 수신되어 처리 중
• 2XX (Successful): 서버가 요청을 성공적으로 처리
  • 200 OK: 요청 성공
  • 201 Created: 요청 성공으로 새로운 리소스 생성됨 (POST)
  • 202 Accepted: 요청이 접수되었으나 처리가 완료되지 않음
  • 204 No Content: 서버가 요청을 성공적으로 수행했으나 응답 페이로드 본문에 보낼 데이터가 없음
• 3XX (Redirection): 요청 완료를 위해 추가 행동 필요
• 4XX (Client Error): 클라이언트 오류, 잘못된 문법 등으로 서버가 요청 수행 불가
  • 400 Bad Request: 잘못된 요청이어서 서버가 처리 불가
  • 401 Unauthorized: 해당 리소스에 대한 클라이언트의 인증 필요
  • 403 Forbidden: 서버가 요청을 이해했지만 승인 거부
  • 404 Not Found: 요청 리소스를 찾을 수 없음
• 5XX (Server Error): 서버가 유효한 요청 처리에 실패
  • 500 Internal Server Error: 서버 내부 문제로 오류 발생. 정확한 원인을 찾을 수 없음
  • 502 Bad Gateway: 서버가 요청 처리에 필요한 응답을 얻기 위해 게이트웨이로 작업하는 동안 잘못된 응답을 받음
  • 503 Service Unavailable: 서비스 이용 불가
  • 504 Gateway Timeout: 게이트웨이가 연결된 서버로부터 응답을 적절한 시간 내에 받을 수 없음