14장. HTTP 계약

status, method safety/idempotency, content type, cache, retry-after, pagination, error shape를 계약으로 본다. 200 응답 안의 {success:false}는 proxy·monitoring이 실패를 놓치게 한다.

400/401/403/404/409/422/429/5xx를 업무 의미에 맞춘다. 내부 SQL·stack을 오류 응답에 노출하지 않는다. client가 재시도할 수 있는지 machine-readable code와 Retry-After로 알린다.

계약 테스트는 provider/consumer fixture를 version control한다. backward compatible additive change와 파괴 변경을 구분한다.