Скачивание результата

Базовый URL https://api.accessful.de/api/v1/upload-service. Для прямого скачивания и создания ссылок требуется X-API-Key — см. Аутентификация.

GET /download/{caseId}

Возвращает сконвертированный PDF/UA как бинарный application/pdf с Content-Disposition: attachment. Ответ также несёт заголовок pdf-version с номером итерации. Необязательная строка запроса ?suffix= добавляется к имени скачиваемого файла.

404 возвращается, пока результат ещё не существует — сначала опрашивайте статус задачи до completed.

Временная ссылка для браузера

POST /download/{caseId}/link
X-API-Key: <ваш-ключ>

После completed владелец получает 200 с downloadUrl, expiresAt (ISO 8601), filename и mimeType: application/pdf. Подписанный HTTPS-адрес действует пять минут и разрешает скачивание только указанной версии без API-ключа. Повторите запрос для новой ссылки. Не записывайте её в журналы и не публикуйте.

Создание ссылки возвращает 403 для чужой задачи, 404 для неизвестной, 409 для незавершённой и 503, если ссылки отключены. Цель: GET /download/signed?token=…. Истёкший или изменённый токен даёт 403, удалённый результат — 404. Успешный ответ содержит Cache-Control: no-store и Referrer-Policy: no-referrer.