Rezultate și descărcări
Listează artefactele
Section titled “Listează artefactele”GET /api/v1/artifacts?job_id={job_id}GET /api/v1/artifacts/{artifact_id}Artefactele sunt vizibile doar pentru contul care le deține. Citiți lista după finalizarea sarcinii.
Descărcare directă
Section titled “Descărcare directă”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"Descărcările suportă ETag și cererile condiționate. Transmiterea în flux a fișierelor mari către disc se face în loc să fie citite complet în memorie deodată.
Strategia de descărcare
Section titled “Strategia de descărcare”GET /api/v1/artifacts/{artifact_id}/download-linkReturnează:
{ "mode": "direct", "url": "https://download.example/...", "filename": "report.en.docx"}Clientii trebuie de asemenea să gestioneze url fiind null; apoi să folosească punctul terminal de descarcare directă. Obțineți un nou URL cu durată scurtă de viață după expirarea celui anterior.
Previsualizare
Section titled “Previsualizare”GET /api/v1/artifacts/{artifact_id}/preview-urlRezultatele HTML, SVG și XML sunt întotdeauna descărcate sub formă de atașamente.
Numele fișierelor
Section titled “Numele fișierelor”Analizați mai întâi RFC 5987 filename*, apoi recurgeți la filename. Indiferent care dintre acestea folosiți, păstrați doar numele de bază și truncați sau înlocuiți caracterele nepermise conform sistemului local de fișiere.
Un job poate returna mai multe artefacte sau un singur rezultat împachetat. Folosiți format din lista artefacterelor și capetele răspunsului de descărcare; nu ghiciți tipul răspunsului pe baza extensiei fișierului sursă.