HTTP 클라이언트와 서버의 요청 계약

요청 생성

브라우저가 method, URL, header, body를 구성해 서버에 보낸다.

서버는 인증과 검증을 거친 뒤 도메인 로직을 실행한다.

상태 코드와 JSON 또는 HTML을 보내 결과를 명확히 알린다.

클라이언트는 성공, 로딩, 오류 상태를 분리해 사용자에게 보여준다.

GET

조회 부작용 없이 데이터를 읽고 캐시 가능성을 가진다

민감 정보 query 노출

POST

생성·명령 새 리소스 생성이나 처리 요청에 사용

중복 제출 방지 필요

PUT/PATCH

수정 전체 교체와 부분 변경의 의미를 구분

낙관적 갱신은 실패 복구 포함

DELETE

삭제 삭제 권한과 복구 정책을 함께 고려

idempotency 기대를 확인

상태 코드 성공, validation, 인증, 서버 오류가 다른 코드로 표현된다.

권한 클라이언트 표시와 별개로 서버에서 다시 확인한다.

로딩 상태 사용자가 요청 중인지 재시도 가능한지 알 수 있다.

계약 문서 요청 body와 응답 스키마가 예제로 남아 있다.