클라이언트/서버 계약

클라이언트와 서버의 요청·응답 계약

프론트엔드는 필요한 데이터를 요청하고 서버는 정해진 형식으로 응답합니다. 계약이 흔들리면 화면과 API가 함께 깨집니다.

통신 경로
01UI event 02Request 03Route 04Response 05Render
클라이언트

사용자 입력을 요청으로 바꾸고 로딩, 성공, 실패 상태를 화면에 반영합니다.

서버

라우트와 비즈니스 로직을 통해 데이터를 검증하고 응답을 만듭니다.

상태 코드

성공, 인증 실패, 검증 오류, 서버 오류를 숫자와 메시지로 구분합니다.

계약 문서

필드 이름, 타입, 에러 형식이 맞아야 양쪽 수정 비용이 줄어듭니다.