跳到主要内容
Sursa Developers

对象

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

    按 ID 指定合集。同时传入 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 相同。

使用方