리소스 식별
명사 URL과 안정된 id로 대상을 표현
REST API 계약은 리소스·행동·표현·오류를 순서대로 점검한다
URL 모양만 맞추지 않고 같은 요청이 예측 가능한 상태 전이와 응답을 만드는지 확인한다.
HTTP 의미
GET·POST·PATCH·DELETE의 안전성·멱등성 반영
표현 계약
필드 타입·nullable·페이지네이션을 문서화
오류 모델
status와 재처리 가능한 machine code를 일관되게 반환
핵심API 계약은 서버 구현이 아니라 클라이언트가 의존할 수 있는 관찰 가능한 행동이다.