문서 생성
노션 페이지, 포스트(서식 있는 텍스트 또는 HTML 페이지), 리드 수집 폼으로 DocuRise 문서를 생성합니다
인증
Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를
가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한
번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된
키는 바로 다음 요청부터 인증에 실패합니다.
헤더
이 생성 시도를 식별하는 클라이언트 생성 고유 문자열(255자 이하)입니다. 위의 "멱등성" 항목을 참고하세요.
255본문
- Notion 페이지
- 포스트: content (서식 있는 텍스트)
- 포스트: html (HTML 페이지)
- 리드 수집 폼
POST /api/preview/documents의 본문입니다. kind가 세 가지 본문(notion, post, form) 중 어느
것을 쓸지 정합니다. kind가 없거나 알 수 없는 값이거나, 다른 종류에 속한 필드를 보내면
400 VALIDATION_ERROR입니다. post 본문은 content(서식 있는 텍스트 HTML)와 html(HTML 페이지)
중 정확히 하나만 받습니다. 둘 다 보내거나 둘 다 보내지 않으면
400 VALIDATION_ERROR입니다.
문서 종류를 정합니다. 이 본문에서는 항상 notion입니다.
notion 문서 제목으로, 공개 페이지에 표시됩니다.
1 - 200웹에 게시(공개 공유)된 노션 페이지의 URL입니다. DocuRise는 이를 인증 없이 가져옵니다 — 설정할 계정별 노션 연동이 없습니다.
공개 페이지에 표시되는 선택 사항 부제목입니다.
500live(기본값)만 받습니다. 노션 문서에는 초안 상태가 없으므로 draft는
422 STATUS_NOT_SUPPORTED이고, 꺼진 상태의 문서를 만드는 것은 아직 지원되지 않으므로
inactive도 422 STATUS_NOT_SUPPORTED입니다(문서를 만든 뒤 PATCH로 status를
inactive로 바꾸세요).
live