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

الكائنات

TextCardRequest

الحقول

  • titlestringمطلوب

    length ≥ 1, length ≤ 200

  • collectionstring

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

  • body_markdownstring

    نص البطاقة بصيغة Markdown؛ لا يُطبَّق عليه content_type. ويمكنك تمرير body بدلًا منه.

    length ≥ 1, length ≤ 500000

  • tagsarray of string | null

    items ≤ 30

  • categorystring | null

    length ≤ 60

  • sensitiveboolean | null
  • owner_idinteger | null
  • asyncboolean

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

  • bodystring

    نص البطاقة بالصيغة المحددة في content_type. مرّر إما body أو body_markdown؛ وتمرير الاثنين يعيد 422 validation.failed.

    length ≥ 1, length ≤ 500000

  • content_typeCardTextContentType
  • collection_idinteger | null

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

  • folder_idstring | null

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

    length ≤ 64

  • external_idstring | null

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

    length ≤ 512

  • metadataMetadataPatch

يُستخدم في