REST 계약

REST API 설계

Express로 구현할 때도 URI 이름, HTTP 메서드, 상태 코드, JSON 모양이 서로 같은 의도를 가리켜야 합니다.

URI

자원

명사와 복수형으로 무엇을 다루는지 표현합니다.

GET

조회

데이터를 읽고 서버 상태를 바꾸지 않습니다.

POST

생성

요청 바디를 검증한 뒤 새 자원을 만듭니다.

PUT

전체 갱신

자원 전체를 새 표현으로 교체하는 의미입니다.

PATCH

부분 갱신

일부 필드만 바꿀 때 의도를 더 분명히 합니다.

상황
상태 코드
본문
클라이언트 처리
목록
200 OK
배열 JSON
목록 렌더링
생성
201 Created
생성된 객체
상세 이동 또는 목록 갱신
삭제
204 No Content
없음
로컬 항목 제거
실패
400 / 404
message
폼 오류 또는 빈 상태 표시