تخطَّ إلى المحتوى

النتائج والتنزيلات

GET /api/v1/artifacts?job_id={job_id}
GET /api/v1/artifacts/{artifact_id}

تظهر القطع الأثرية فقط لحساب المالك. اقرأ القائمة بعد اكتمال المهمة.

GET /api/v1/artifacts/{artifact_id}/download
Terminal window
curl --fail-with-body -OJ \
https://omnidoc.top/api/v1/artifacts/6n2b7z5q8v4m1c3k/download \
-H "X-API-Key: $OMNIDOC_API_KEY"

يدعم التنزيل ETag والطلبات الشرطية. يتيح تدفق الملفات الكبيرة إلى القرص بدلاً من قراءتها دفعة واحدة إلى الذاكرة.

GET /api/v1/artifacts/{artifact_id}/download-link

الإرجاع:

{
"mode": "direct",
"url": "https://download.example/...",
"filename": "report.en.docx"
}

يتعين على العملاء أيضًا التعامل مع url باعتباره null؛ ثم استخدام نقطة نهاية التنزيل المباشر. احصل على عنوان URL جديد قصير العمر بعد انتهاء صلاحية العنوان السابق.

GET /api/v1/artifacts/{artifact_id}/preview-url

يتم دائمًا تنزيل نتائج HTML وSVG وXML كمرفقات.

قم أولاً بتحليل RFC 5987 filename*، ثم انتقل إلى filename. أيّاً كان الخيار الذي تستخدمه، احتفظ فقط بالاسم الأساسي للملف، واقصِر أو استبدل الأحرف غير المسموح بها وفقاً لنظام الملفات المحلي لديك.

قد يُرجع المهمة عدة نواتج أو نتيجة واحدة مجمَّعة. اعتمد على format في قائمة النواتج ورؤوس استجابة التنزيل؛ ولا تخمِّن نوع الاستجابة من امتداد ملف المصدر.