النتائج والتنزيلات
قائمة المصنوعات
Section titled “قائمة المصنوعات”GET /api/v1/artifacts?job_id={job_id}GET /api/v1/artifacts/{artifact_id}تظهر القطع الأثرية فقط لحساب المالك. اقرأ القائمة بعد اكتمال المهمة.
التنزيل المباشر
Section titled “التنزيل المباشر”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"يدعم التنزيل ETag والطلبات الشرطية. يتيح تدفق الملفات الكبيرة إلى القرص بدلاً من قراءتها دفعة واحدة إلى الذاكرة.
استراتيجية التنزيل
Section titled “استراتيجية التنزيل”GET /api/v1/artifacts/{artifact_id}/download-linkالإرجاع:
{ "mode": "direct", "url": "https://download.example/...", "filename": "report.en.docx"}يتعين على العملاء أيضًا التعامل مع url باعتباره null؛ ثم استخدام نقطة نهاية التنزيل المباشر. احصل على عنوان URL جديد قصير العمر بعد انتهاء صلاحية العنوان السابق.
معاينة
Section titled “معاينة”GET /api/v1/artifacts/{artifact_id}/preview-urlيتم دائمًا تنزيل نتائج HTML وSVG وXML كمرفقات.
أسماء الملفات
Section titled “أسماء الملفات”قم أولاً بتحليل RFC 5987 filename*، ثم انتقل إلى filename. أيّاً كان الخيار الذي تستخدمه، احتفظ فقط بالاسم الأساسي للملف، واقصِر أو استبدل الأحرف غير المسموح بها وفقاً لنظام الملفات المحلي لديك.
قد يُرجع المهمة عدة نواتج أو نتيجة واحدة مجمَّعة. اعتمد على format في قائمة النواتج ورؤوس استجابة التنزيل؛ ولا تخمِّن نوع الاستجابة من امتداد ملف المصدر.