Перейти к содержимому

Результаты и загрузки

GET /api/v1/artifacts?job_id={job_id}
GET /api/v1/artifacts/{artifact_id}

Артефакты видны только для аккаунта-владельца. Прочитайте список после завершения задания.

GET /api/v1/artifacts/{artifact_id}/download
Окно терминала
curl --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 в списке артефактов и заголовки ответа при загрузке; не определяйте тип ответа по расширению исходного файла.