# 오류 처리 및 재시도

[HTML](https://pdfcraft.ai/ko-KR/docs/api/error-handling/) · [Site index](https://pdfcraft.ai/llms.txt)

변환 작업이 실패하거나 예상보다 오래 걸릴 때 예측 가능한 통합을 구축하세요.


변환 결과를 동기식 파일 다운로드가 아닌 상태 기반 작업으로 취급하세요. 이렇게 하면 원본 파일이 크거나, 사용할 수 없거나, 형식이 잘못된 경우에도 제품의 안정성을 유지할 수 있습니다.

## 안전하게 재시도

반복해도 안전한 요청만 재시도하세요. 결과 요청은 지수 백오프를 사용하여 재시도할 수 있습니다. 제출 요청의 경우, 다른 제출을 시도하기 전에 성공적인 응답에서 반환된 작업 ID를 저장하세요.

## 최종 실패 처리

작업이 `failed` 상태일 때, 작업 ID와 반환된 이유를 내부 작업 ID와 함께 기록하세요. 서식 없는 API 오류를 노출하는 대신, 원본 URL을 확인하거나 읽을 수 있는 PDF를 업로드하는 것과 같이 사용자가 실행할 수 있는 다음 단계를 보여주세요.

## 실용적인 시간 제한 설정

제품 경험에 맞는 폴링 마감 시간을 사용하세요. 해당 마감 시간에 폴링을 중단하고, 작업 ID를 보관하며, 백그라운드 워커나 사용자가 시작한 새로 고침이 나중에 최종 상태를 확인하도록 하세요.

정확한 응답 필드와 실패 예시는 [API Reference](https://pdfcraft.ai/ko-KR/api/)를 참조하세요.