# Обработка ошибок и повторные попытки

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

Создайте предсказуемую интеграцию, когда задачи конвертации завершаются неудачно или занимают больше времени, чем ожидалось.


Рассматривайте результат конвертации как задачу с сохранением состояния, а не как синхронную загрузку файла. Это обеспечивает надёжность вашего продукта, когда исходные файлы большие, недоступны или имеют неверный формат.

## Безопасные повторные попытки

Повторяйте только те запросы, которые безопасно повторять. Запрос результата можно повторять с экспоненциальной задержкой. Для запросов на отправку сохраните ID задачи, возвращённый успешным ответом, прежде чем пытаться отправить её снова.

## Обработка окончательных сбоев

Когда задача находится в состоянии `failed`, зарегистрируйте её ID задачи и возвращённую причину вместе с вашим внутренним ID задачи. Покажите пользователям выполнимый следующий шаг, например проверку исходного URL или загрузку читаемого PDF, вместо того чтобы показывать неформатированную ошибку API.

## Установите практичные ограничения по времени

Используйте крайний срок опроса, соответствующий опыту вашего продукта. Прекратите опрос по достижении этого срока, сохраните ID задачи и позвольте фоновому обработчику или обновлению, инициированному пользователем, проверить окончательный статус позже.

Точные поля ответа и примеры сбоев см. в [справочнике по API](https://pdfcraft.ai/ru-RU/api/).