الكائنات

CardUploadForm

الحقول

• filestring (application/octet-stream)مطلوب
• collectionstring

  القيمة الافتراضية: "default"

• tagsstring

  القيمة الافتراضية: ""

• forceboolean

  القيمة الافتراضية: false

• owner_idinteger | null
• verify_interval_daysinteger | null
• categorystring | null
• sensitiveboolean | null
• asyncboolean

  القيمة الافتراضية: false

• reviewboolean

  القيمة الافتراضية: false

• folder_idstring | null

  مجلد في المجموعة collection توضع فيه البطاقة الجديدة. المجلد من مجموعة أخرى يعيد 400 folders.card_collection_mismatch، والمجلد غير الموجود يعيد 404 folders.not_found، وغياب الصلاحية COLLECTION_EDIT_CARDS على المجلد يعيد 403 authz.forbidden. يجري الفحص قبل حفظ الملف. النسخة المكررة من ملف مرفوع بالفعل (skipped) لا تُنقل إلى المجلد.

  length ≤ 64

• collection_idinteger | null

  المجموعة حسب المعرّف. إذا مُرِّر collection أيضًا، فالأولوية للحقل collection_id. المجموعة غير الموجودة في المؤسسة أو غير المرئية تعيد 404 collections.not_found.

• external_idstring | null

  قيمة external_id للبطاقة الجديدة. معها تُنشأ البطاقة حتى إن كان الملف نفسه موجودًا في المجموعة. إذا كانت بطاقة أخرى في المؤسسة تستخدم هذه القيمة، يعيد الطلب 409 cards.external_id_taken. لإنشاء بطاقة أو استبدالها حسب external_id، استخدم PUT /v1/cards-by-external-id/{external_id}.

  length ≤ 512

• metadatastring | null

  قيمة metadata للبطاقة الجديدة: كائن JSON بوصفه قيمة حقل النموذج. القواعد هي قواعد MetadataPatch.

يُستخدم في

• POST/v1/cardsرفع ملف بوصفه بطاقة