(Binary file content — save the response to a file)
{ "error": "Document not found"}
Завантаж документ лабораторного звіту за його ID файлу. Повертає необроблені байти файлу з відповідним заголовком Content-Type. ID документів можна отримати з масиву documents у відповіді Отримати результати аналізів.Потребує дозволу results_view.
Доступ перевіряється за профілем, якому належить документ. Документ, завантажений через Завантажити документ, перевіряється за групою профілів, у яку його завантажено.
Запит
Параметри шляху
string
обов'язково
ID файлу (UUID) з масиву documents у відповіді з результатами запису.
Відповідь
У разі успіху API повертає 200 OK із байтами файлу та чотирма заголовками. Кожен заголовок містить поле масиву documents:
Original-File-Name передається в UTF-8 із відсотковим кодуванням, оскільки заголовок не може містити всі символи, які можуть бути в назві завантаженого файлу. Декодуй його за допомогою decodeURIComponent або аналога.ETag та If-None-Match — це стандартні HTTP-заголовки кешування (RFC 9110). Надішли наявний у тебе etag у заголовку If-None-Match, щоб пропустити незмінений файл. Тоді API відповість 304 Not Modified без тіла відповіді.
Відповіді з помилками
Статус
Опис
304
Не змінено — etag із If-None-Match досі відповідає файлу. Без тіла відповіді.
400
Неправильний формат ID — передане значення не є коректним UUID.
403
Доступ заборонено — твій API-ключ не має доступу до цієї операції або документ поза твоїм контекстом доступу.