انتقل إلى المحتوى
Sursa Developers

الكائنات

Upload

عملية رفع متعدد الأجزاء.

الحقول

  • idstringمطلوب

    معرّف عملية الرفع (upl_ يليه 32 حرفًا ست عشريًا).

  • purposeUploadPurposeمطلوب
  • filenamestringمطلوب

    اسم الملف (بلا مجلدات).

  • content_typestringمطلوب

    نوع المحتوى المعلن؛ فارغ إن لم يُعلَن.

  • sizeinteger (int64)مطلوب

    حجم الملف بالبايت.

  • sha256string | nullمطلوب

    قيمة SHA-256 للملف، المعلنة عند الإنشاء أو في الخطوة complete؛ والقيمة null إن لم تكن معروفة بعد.

  • statusUploadStatusمطلوب
  • part_sizeinteger (int64)مطلوب

    حجم كل جزء عدا الأخير (من 5 إلى 100 ميبيبايت).

  • part_countintegerمطلوب

    عدد الأجزاء.

    ≥ 1, ≤ 1000

  • parts_receivedintegerمطلوب

    عدد الأجزاء المستلمة.

    ≥ 0

  • partsarray of UploadPartمطلوب

    الأجزاء المستلمة حسب الرقم (فارغ في استجابة POST /v1/uploads).

  • reject_reasonstring | nullمطلوب

    سبب الرفض (rejected): checksum_mismatch، وtype_mismatch، وunsupported_format، وinfected، وscan_unavailable، وunsafe_content. قد يتوسع التعداد؛ والقيمة null إن لم تُرفض عملية الرفع.

  • reject_detailsobject | nullمطلوب

    تفاصيل الرفض (الامتداد، والصيغة المعلنة والمكتشفة، والمجاميع الاختبارية)؛ والقيمة null إن لم تُرفض عملية الرفع.

  • created_atstring (date-time)مطلوب

    وقت إنشاء عملية الرفع.

  • expires_atstring (date-time)مطلوب

    الموعد النهائي لإكمال عملية الرفع، ثم لاستخدامها بعد أن تصبح جاهزة.

  • completed_atstring (date-time) | nullمطلوب

    وقت انتهاء الفحص (ready أو rejected).

  • consumed_atstring (date-time) | nullمطلوب

    وقت استخدام عملية الرفع (لبطاقة أو أرشيف أو استيراد).

يُستخدم في