처음이어도 괜찮아요 · 그림부터 시작해요
POST create와 action 경계를 response 계약으로 닫는다
POST가 새 resource를 만들었는지 기존 resource에 action을 수행했는지 operation contract로 구분하고 status·Location·representation·effect receipt를 일관되게 해석한다. 모든 POST 2xx를 생성 성공으로 간주해 Location 부재·중복 action·비동기 접수 상태를 놓친다.를 방치하면 자동화가 빠르게 반복될수록 잘못된 효과와 비노출 사고도 함께 확대됩니다.
아직 답을 몰라도 괜찮아요. 아래 작은 예시를 보고 먼저 예상해 보세요.01 · 가볍게 시작하기
정답을 보기 전에 먼저 골라볼까요?
aa05 synthetic request/response script · fixed clock · fake credential sentinel · outbound network disabled- 1먼저 골라보기
틀려도 괜찮아요. 지금 생각한 답 하나를 정해요.
- 2그림으로 확인하기
움직이는 순서와 달라지는 곳만 천천히 찾아요.
- 3내 말로 다시 말하기
한 문장으로 말해 보면 내가 이해한 곳을 확인할 수 있어요.
02 · 그림으로 보기
그림이 움직이는 순서를 직접 확인해요
- 01관찰POST · Location · 201 Created · 202 Accepted
- 02추론POST가 새 resource를 만들었는지 기존 resource에 action을 수행했는지 operation contract로 구분하고 status·Location·representation·effect receipt를 일관되게 해석한다. 모든 POST 2xx를 생성 성공으로 간주해 Location 부재·중복 action·비동기 접수 상태를 놓친다.가 발생하면 HTTP 수신 성공과 업무 성공을 분리하고 재시도·중단·격리·사람 개입 중 하나를 정책으로 결정한다. operation kind·status·Location policy·resource/effect identifier·follow-up decision receipt는 raw credential·private URL·개인 데이터 없이도 동일 결정을 재현할 만큼 충분해야 한다.
- 03검증POST create와 action 경계를 response 계약으로 닫는다의 request·response·effect 계약과 terminal/retryable/unknown-effect 분기를 실행 전에 표로 고정한다. 모든 POST 2xx를 생성 성공으로 간주해 Location 부재·중복 action·비동기 접수 상태를 놓친다.를 live API나 실제 credential 없이 재현하고 최초 policy divergence를 국소화한다. operation kind·status·Location policy·resource/effect identifier·follow-up decision receipt로 정상·경계·실패·replay 결과와 비노출을 함께 입증한다.
처음 보는 말도 책 읽듯 풀어봐요
이 수업은 쉬운 뜻과 생활 예를 아직 함께 준비하지 못했어요. 설명 없는 정확한 이름은 먼저 보여 주지 않을게요.
그림에서 찾을 쉬운 규칙
- 01POST가 새 resource를 만들었는지 기존 resource에 action을 수행했는지 operation contract로 구분하고 status·Location·representation·effect receipt를 일관되게 해석한다.
- 02모든 POST 2xx를 생성 성공으로 간주해 Location 부재·중복 action·비동기 접수 상태를 놓친다.가 발생하면 HTTP 수신 성공과 업무 성공을 분리하고 재시도·중단·격리·사람 개입 중 하나를 정책으로 결정한다.
- 03operation kind·status·Location policy·resource/effect identifier·follow-up decision receipt는 raw credential·private URL·개인 데이터 없이도 동일 결정을 재현할 만큼 충분해야 한다.
03 · 같이 풀어보기
한 단계씩 따라가면 어렵지 않아요
문서 생성과 변환 job 제출을 함께 지원하는 client의 축소된 local fake server에서 POST create와 action 경계를 response 계약으로 닫는다 계약을 검토한다.
aa05 synthetic request/response script · fixed clock · fake credential sentinel · outbound network disabled04 · 이제 내가 해볼 차례
여기까지 오면 이런 일을 할 수 있어요
POST가 새 resource를 만들었는지 기존 resource에 action을 수행했는지 operation contract로 구분하고 status·Location·representation·effect receipt를 일관되게 해석한다.을 설명하고 create/action/accepted 세 POST 결과를 구분하는 response interpreter를 구현한다.을 local synthetic 환경에서 실행해 operation kind·status·Location policy·resource/effect identifier·follow-up decision receipt로 검증한다.
- POST create와 action 경계를 response 계약으로 닫는다의 request·response·effect 계약과 terminal/retryable/unknown-effect 분기를 실행 전에 표로 고정한다.
- 모든 POST 2xx를 생성 성공으로 간주해 Location 부재·중복 action·비동기 접수 상태를 놓친다.를 live API나 실제 credential 없이 재현하고 최초 policy divergence를 국소화한다.
- operation kind·status·Location policy·resource/effect identifier·follow-up decision receipt로 정상·경계·실패·replay 결과와 비노출을 함께 입증한다.
05 · 자주 헷갈리는 지점
틀린 답도 이유를 알면 다음에는 맞힐 수 있어요
01POST create와 action 경계를 response 계약으로 닫는다에서는 2xx 또는 예외 없음만 확인하면 계약 전체가 검증된다.
한 번 더 생각해 볼 질문aa05 synthetic exchange에서 transport 성공이지만 계약이 깨지는 반례와 판정 신호를 쓰세요.
이렇게 고쳐 생각해요POST가 새 resource를 만들었는지 기존 resource에 action을 수행했는지 operation contract로 구분하고 status·Location·representation·effect receipt를 일관되게 해석한다.
02모든 POST 2xx를 생성 성공으로 간주해 Location 부재·중복 action·비동기 접수 상태를 놓친다.가 생기면 같은 요청을 제한 없이 반복하는 것이 가장 안전하다.
한 번 더 생각해 볼 질문aa05 실패를 retryable·terminal·unknown-effect 중 하나로 분류하고 다음 행동을 쓰세요.
이렇게 고쳐 생각해요재시도 가능성·deadline·attempt budget·효과 중복 가능성을 먼저 판정하고 허용된 경우에만 bounded recovery를 수행한다.
03operation kind·status·Location policy·resource/effect identifier·follow-up decision receipt 대신 raw request·token·response body 전체를 저장해야만 디버깅할 수 있다.
한 번 더 생각해 볼 질문aa05 증거에서 제거할 값과 유지할 결정 신호를 각각 세 개 적으세요.
이렇게 고쳐 생각해요allowlist field·hash·length·status·attempt·synthetic identifier로 증거를 최소화하고 민감 값은 수집 전에 제거한다.
06 · 더 궁금할 때만 보기