Objectes

CardUploadForm

Camps

• filestring (application/octet-stream)obligatori
• collectionstring

  Per defecte: "default"

• tagsstring

  Per defecte: ""

• forceboolean

  Per defecte: false

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

  Per defecte: false

• reviewboolean

  Per defecte: false

• folder_idstring | null

  Carpeta de collection on es posa l’entrada nova. Una carpeta d’una altra col·lecció retorna 400 folders.card_collection_mismatch, una carpeta que no existeix retorna 404 folders.not_found, i sense el permís COLLECTION_EDIT_CARDS sobre la carpeta es retorna 403 authz.forbidden. La comprovació es fa abans de desar el fitxer. Un duplicat d’un fitxer que ja s’ha pujat (skipped) no es mou a la carpeta.

  length ≤ 64

• collection_idinteger | null

  Col·lecció per ID. Quan també es passa collection, preval collection_id. Una col·lecció que no existeix a l’organització o que no és visible retorna 404 collections.not_found.

• external_idstring | null

  external_id de l’entrada nova. Amb aquest camp, l’entrada es crea encara que la col·lecció ja tingui el mateix fitxer. Si una altra entrada de l’organització el fa servir, la sol·licitud retorna 409 cards.external_id_taken. Per crear o substituir una entrada per external_id, feu servir PUT /v1/cards-by-external-id/{external_id}.

  length ≤ 512

• metadatastring | null

  metadata de l’entrada nova: un objecte JSON com a valor del camp del formulari. Les regles són les de MetadataPatch.

S’usa a

• POST/v1/cardsPujar un fitxer com a entrada