Precondition Required

개요

428 Precondition Required는 서버가 이 요청을 반드시 조건부(conditional)로 보내도록 요구한다는 뜻입니다. 클라이언트가 If-Match 같은 전제 조건 헤더 없이 쓰기 요청을 보내면, 서버가 이를 거부하고 조건을 붙이라고 요구합니다.

이 코드의 목적은 '잃어버린 갱신(lost update)' 방지입니다. 두 클라이언트가 같은 리소스를 각자 조회한 뒤 순서대로 저장하면 뒤 저장이 앞 저장을 조용히 덮어씁니다. 서버가 If-Match를 강제하면 이런 무조건적 덮어쓰기를 막을 수 있습니다.

언제 발생하나

• 리소스 수정(PUT/PATCH/DELETE) 요청에 조건 헤더가 없을 때
• 서버가 낙관적 동시성 제어를 강제하도록 설정된 경우
• 무조건적 덮어쓰기를 정책적으로 금지한 API

요청 / 응답 예시

PUT /docs/42 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"title":"New"}

HTTP/1.1 428 Precondition Required
Content-Type: application/json

{"error":"precondition_required","hint":"Include an If-Match header with the current ETag."}

코드로 보기

app.put('/docs/:id', (req, res) => {
  if (!req.headers['if-match']) {
    return res.status(428).json({
      error: 'precondition_required',
      hint: 'Include an If-Match header with the current ETag.'
    });
  }
  // proceed with the conditional update...
});

실무 참고

• 428은 조건이 '없어서' 나는 오류이고, 412 Precondition Failed는 조건은 있지만 '거짓'일 때 납니다. 둘을 혼동하지 마세요.
• 428로 If-Match를 붙였는데도 저장 시점에 리소스가 바뀌었다면, 그때는 412가 반환됩니다.

관련 상태코드

관련 헤더

스펙 근거