Ergebnis herunterladen

Basis-URL https://api.accessful.de/api/v1/upload-service. Direkter Download und Link-Erstellung benötigen den X-API-Key-Header — siehe Authentifizierung.

GET /download/{caseId}

Liefert das konvertierte PDF/UA als binäres application/pdf mit Content-Disposition: attachment. Die Antwort trägt zudem einen pdf-version-Header mit der Iterationsnummer. Ein optionaler ?suffix=-Query wird an den Dateinamen angehängt.

404 wird zurückgegeben, solange noch kein Ergebnis existiert — polle zuerst den Job-Status bis completed.

Kurzlebiger Browser-Download-Link

POST /download/{caseId}/link
X-API-Key: <dein-key>

Nach completed erhält der Eigentümer 200 mit downloadUrl, expiresAt (ISO 8601), filename und mimeType: application/pdf. Die signierte HTTPS-URL gilt fünf Minuten und erlaubt im Browser ohne API-Key nur den Download der ausgewählten Ergebnisversion. Ein erneuter Aufruf erneuert den Link. Die URL gehört nicht in Logs oder öffentliche Nachrichten.

Die Link-Ausgabe liefert 403 für fremde, 404 für unbekannte und 409 für noch nicht abgeschlossene Aufträge; 503, falls signierte Links nicht aktiviert sind. Ziel ist GET /download/signed?token=…. Abgelaufene oder manipulierte Tokens liefern 403, gelöschte Ergebnisse 404. Erfolgreiche Downloads setzen Cache-Control: no-store und Referrer-Policy: no-referrer.