Рассматривайте результат конвертации как задачу с сохранением состояния, а не как синхронную загрузку файла. Это обеспечивает надёжность вашего продукта, когда исходные файлы большие, недоступны или имеют неверный формат.
Безопасные повторные попытки
Повторяйте только те запросы, которые безопасно повторять. Запрос результата можно повторять с экспоненциальной задержкой. Для запросов на отправку сохраните ID задачи, возвращённый успешным ответом, прежде чем пытаться отправить её снова.
Обработка окончательных сбоев
Когда задача находится в состоянии failed, зарегистрируйте её ID задачи и возвращённую причину вместе с вашим внутренним ID задачи. Покажите пользователям выполнимый следующий шаг, например проверку исходного URL или загрузку читаемого PDF, вместо того чтобы показывать неформатированную ошибку API.
Установите практичные ограничения по времени
Используйте крайний срок опроса, соответствующий опыту вашего продукта. Прекратите опрос по достижении этого срока, сохраните ID задачи и позвольте фоновому обработчику или обновлению, инициированному пользователем, проверить окончательный статус позже.
Точные поля ответа и примеры сбоев см. в справочнике по API.