본문으로 건너뛰기
Sursa Developers

객체

CardTextUpsert

PUT /v1/cards-by-external-id/{external_id} 오퍼레이션용 텍스트 카드. 카드가 없으면 생성돼요(title 필드와 body 필드가 필요해요). 카드가 있으면 텍스트가 바뀐 경우 새 버전으로 교체되고, 카드 정보는 전달한 값을 따라요. 컬렉션과 폴더는 카드를 생성할 때만 적용돼요.

필드

  • titlestring

    length ≥ 1, length ≤ 200

  • bodystring필수

    content_type 형식의 카드 텍스트.

    length ≥ 1, length ≤ 500000

  • collectionstring

    카드를 생성할 때 이름으로 지정하는 컬렉션. 기본값은 설치 환경의 기본 컬렉션이에요.

  • collection_idinteger | null

    카드를 생성할 때 ID로 지정하는 컬렉션. 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

  • asyncboolean

    true이면 즉시 반환하고 대기열에서 카드를 인덱싱해요. false이면 인덱싱이 끝난 뒤 반환해요.

    기본값: false

사용처