الكائنات

CardTextUpsert

الحقول

• titlestring

  length ≥ 1, length ≤ 200

• bodystringمطلوب

  نص البطاقة بالصيغة المحددة في content_type.

  length ≥ 1, length ≤ 500000

• content_typeCardTextContentType
• collectionstring

  المجموعة حسب الاسم، عند إنشاء البطاقة. افتراضيًا، المجموعة الافتراضية في التثبيت.

• collection_idinteger | null

  المجموعة حسب المعرّف، عند إنشاء البطاقة. إذا مُرِّر collection أيضًا، فالأولوية للحقل collection_id.

• folder_idstring | null

  مجلد في المجموعة للبطاقة الجديدة، مع الفحوص نفسها التي يخضع لها folder_id عند رفع ملف.

  length ≤ 64

• tagsarray of string | null

  items ≤ 30

• categorystring | null

  length ≤ 60

• sensitiveboolean | null
• owner_idinteger | null
• verify_interval_daysinteger | null

  ≥ 1, ≤ 3650

• metadataMetadataPatch
• asyncboolean

  القيمة true تعيد الاستجابة فورًا وتفهرس البطاقة في قائمة الانتظار؛ والقيمة false تعيدها بعد الفهرسة.

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

يُستخدم في

• PUT/v1/cards-by-external-id/{external_id}إنشاء بطاقة أو استبدالها بالمعرّف الخارجي