본문으로 건너뛰기
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 객체와 같아요.

사용처