의미
요청이 처리를 위해 접수되었지만 아직 처리가 끝나지 않았습니다. 응답 시점에는 결과를 알 수 없습니다.
흔한 원인
- 작업이 대기열에 들어감(동영상 인코딩, 내보내기, 대량 가져오기)
- 비동기 웹훅이나 이벤트가 접수됨
- 배치 API가 요청을 확인함
해결 방법
클라이언트 또는 방문자라면
Location이나 본문에 있는 상태 URL을 폴링하거나 콜백을 기다리세요. 202를 작업 성공의 증거로 여기지 마세요.
사이트나 API 운영자라면
진행 상황과 최종 결과를 알려주는 작업 리소스 링크를 반환하고, 작업 기록을 얼마나 보관하는지 문서화하세요.
응답 예시
HTTP/1.1
HTTP/1.1 202 Accepted
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /jobs/7f3a/status
Content-Type: application/json
{
"job": "7f3a",
"state": "queued"
}명세
자주 묻는 질문
› 202 작업이 끝났는지 어떻게 알 수 있나요?
API가 반환한 작업 URL을 폴링하거나, 웹훅을 쓰거나, 이벤트를 구독하세요. 202 응답 자체는 바뀌지 않습니다.
› 202를 받은 요청도 실패할 수 있나요?
네. 서버는 시도하겠다고 약속했을 뿐이며, 작업은 나중에 실패하고 상태 리소스에 그 사실을 알릴 수 있습니다.