Результаты и загрузки
Список артефактов
Заголовок раздела «Список артефактов»GET /api/v1/artifacts?job_id={job_id}GET /api/v1/artifacts/{artifact_id}Артефакты видны только для аккаунта-владельца. Прочитайте список после завершения задания.
Прямая загрузка
Заголовок раздела «Прямая загрузка»GET /api/v1/artifacts/{artifact_id}/downloadcurl --fail-with-body -OJ \ https://omnidoc.top/api/v1/artifacts/6n2b7z5q8v4m1c3k/download \ -H "X-API-Key: $OMNIDOC_API_KEY"Поддержка загрузок ETag и условных запросов. Потоковая передача больших файлов на диск вместо их однократного чтения в память.
Стратегия загрузки
Заголовок раздела «Стратегия загрузки»GET /api/v1/artifacts/{artifact_id}/download-linkВозвращает:
{ "mode": "direct", "url": "https://download.example/...", "filename": "report.en.docx"}Клиенты также должны обрабатывать url как null; затем использовать прямой конечный точку загрузки. После истечения срока действия одного URL получайте новый временный URL.
Предварительный просмотр
Заголовок раздела «Предварительный просмотр»GET /api/v1/artifacts/{artifact_id}/preview-urlРезультаты HTML, SVG и XML всегда загружаются в виде вложений.
Имена файлов
Заголовок раздела «Имена файлов»Сначала обработайте RFC 5987 filename*, затем переключитесь на filename. Какой бы вариант вы ни использовали, сохраняйте только базовое имя файла и усекайте или заменяйте недопустимые символы в соответствии с правилами вашей локальной файловой системы.
Задание может вернуть несколько артефактов или один упакованный результат. Ориентируйтесь на format в списке артефактов и заголовки ответа при загрузке; не определяйте тип ответа по расширению исходного файла.