객체

PushDocument

필드

• external_idstring필수

  회사 시스템의 고정된 문서 ID. 같은 ID로 보내면 문서가 교체돼요.

  length ≤ 512

• titlestring필수

  length ≤ 500

• urlstring

  회사 시스템에 있는 문서의 링크(http 또는 https).

• contentstring

  콘텐츠(최대 5MB).

• content_typestring

  허용 값: htmlmarkdowntext

  기본값: "html"

• patharray of string | string

  문서의 폴더: 이름 배열 또는 “/”로 구분한 문자열(최대 10단계).

• permissionsPushPermissions
• tagsarray of string

  items ≤ 50

• author_emailstring

  작성자. Sursa 사용자이면 카드의 담당자가 돼요.

• updated_atstring (date-time)

  회사 시스템에서의 수정 시각(문서 버전의 일부).

• metadataMetadataPatch

  문서 카드의 metadata 값(1.62.0부터): 객체가 카드의 이전 값을 대체하고, {}는 모든 쌍을 제거해요. metadata 필드가 없으면 카드의 메타데이터가 바뀌지 않아요.

• categorystring

  카드의 카테고리: 조직 카테고리의 키(GET /v1/categories), 1.62.0부터.

  length ≤ 64

• verifiersPushVerifiers
• verify_interval_daysinteger

  카드의 검증 주기(일, 1.62.0부터). 없으면 소스의 주기를 써요.

  ≥ 1, ≤ 3650

• upload_idstring

  content 대신 쓰는 멀티파트 업로드의 문서 파일(upl_…, 1.62.0부터). 업로드는 한 번만 사용돼요. 같은 문서를 같은 upload_id 값으로 다시 보내도 업로드가 소진되지 않아요. 설치 환경에서 멀티파트 업로드를 쓸 수 없는 동안에는 문서가 file_rejected 사유로 거부돼요.

  length ≤ 64

• attachmentsarray of string

  멀티파트 업로드(upl_…, 1.62.0부터)로 올린 문서의 첨부 파일: 각 첨부 파일은 같은 폴더, 권한, 카드 필드를 가진 소스의 별도 카드가 돼요. 문서의 새 버전에서 빠진 첨부 파일은 보관돼요.

  items ≤ 20

사용처

• POST/v1/push/sources/{source_id}/documents문서 보내기(생성 또는 교체)

포함하는 객체

PushDocumentBatch