Accepted

개요

202 Accepted는 요청이 처리 대상으로 접수되었지만 아직 완료되지 않았음을 뜻합니다. 서버가 요청을 큐에 넣거나 비동기 작업으로 넘겼을 때, 최종 결과를 기다리지 않고 즉시 응답하기 위한 코드입니다.

요청의 성공 여부가 응답 시점에는 확정되지 않으므로, 보통 작업 상태를 조회할 수 있는 URL(job/status 엔드포인트)을 Location 헤더나 본문으로 함께 제공합니다.

언제 발생하나

• 리포트 생성, 대용량 파일 변환, 이메일 대량 발송처럼 시간이 오래 걸려 백그라운드 워커로 넘기는 작업의 접수 응답으로 사용됩니다.
• 이벤트를 메시지 큐에 넣고 곧바로 반환하는 이벤트 수집 엔드포인트에서도 흔히 쓰입니다.

요청 / 응답 예시

POST /api/reports HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"type":"monthly","month":"2026-07"}

HTTP/1.1 202 Accepted
Location: /api/jobs/8f2a
Content-Type: application/json

{"jobId":"8f2a","status":"queued"}

코드로 보기

app.post('/api/reports', (req, res) => {
  const jobId = queue.enqueue(req.body);
  res.status(202).location(`/api/jobs/${jobId}`).json({ jobId, status: 'queued' });
});

@app.post('/api/reports')
def report():
    job = queue.enqueue(build_report, request.json)
    return {'jobId': job.id, 'status': 'queued'}, 202

실무 참고

• 202는 "성공"이 아니라 "접수"를 의미하므로, 이후 작업이 실패할 수 있음을 클라이언트가 폴링이나 웹훅으로 확인해야 합니다.
• 동기적으로 즉시 완료되는 작업이라면 202가 아니라 200이나 201을 쓰는 것이 더 명확합니다.
• 폴링 부하를 줄이려면 상태 조회 응답에 Retry-After를 넣어 재확인 간격을 안내할 수 있습니다.

관련 상태코드

관련 헤더

스펙 근거