Ergebnisse und Downloads
Liste der Artefakte
Abschnitt betitelt „Liste der Artefakte“GET /api/v1/artifacts?job_id={job_id}GET /api/v1/artifacts/{artifact_id}Artefakte sind nur für das Besitzerkonto sichtbar. Lesen Sie die Liste nach Abschluss des Jobs.
Direkter Download
Abschnitt betitelt „Direkter Download“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"Downloads unterstützen ETag und bedingte Anfragen. Große Dateien werden auf die Festplatte gestreamt, anstatt sie vollständig in den Speicher zu laden.
Download-Strategie
Abschnitt betitelt „Download-Strategie“GET /api/v1/artifacts/{artifact_id}/download-linkRückgabe:
{ "mode": "direct", "url": "https://download.example/...", "filename": "report.en.docx"}Clients müssen außerdem sicherstellen, dass url null ist; anschließend verwenden sie den direkten Download-Endpunkt. Nach Ablauf einer URL wird eine neue, kurzlebige URL abgerufen.
Vorschau
Abschnitt betitelt „Vorschau“GET /api/v1/artifacts/{artifact_id}/preview-urlDie Ergebnisse von HTML, SVG und XML werden stets als Anhänge heruntergeladen.
Dateinamen
Abschnitt betitelt „Dateinamen“Parsen Sie zuerst RFC 5987 filename* und greifen Sie anschließend auf filename zurück. Welche Methode Sie auch immer verwenden, behalten Sie nur den Basisnamen bei und kürzen oder ersetzen Sie ungültige Zeichen gemäß Ihrem lokalen Dateisystem.
Ein Job kann mehrere Artefakte oder ein verpacktes Ergebnis zurückgeben. Orientieren Sie sich an format in der Artefaktliste und den Download-Antwortköpfen; schließen Sie den Antworttyp nicht aus der Erweiterung der Quelldatei ab.