1.47.0

연동형 문서 내용 수정 API 추가

진행 중인 연동형 문서를 수정 모드로 전환한 뒤, 참여자, 요청자 입력란, 첨부파일 요청, 참조자, 문서 파일 등을 수정하고 다시 서명 요청을 이어갈 수 있습니다.

추가된 API

  • POST /documents/{documentId}/start-modification
  • GET /documents/{documentId}/modification
  • PATCH /documents/{documentId}/modification
  • POST /documents/{documentId}/complete-modification
  • POST /documents/{documentId}/cancel-modification

임베디드 연동에서도 내용 수정을 사용할 수 있습니다. 수정 모드 시작 후 기존 임베디드 문서보기 url 조회 API로 embeddedUrl을 발급받으면, 요청자는 임베디드 화면에서 문서 내용을 수정할 수 있습니다.

추가된 Webhook Event

  • document_modification_started : 내용 수정 시작됨
  • document_modification_completed : 내용 수정 완료됨
  • document_modification_approval_requested : 내부결재로 요청된 문서 수정 완료 후 내부결재 재요청됨
  • document_modification_canceled : 내용 수정 취소됨

임베디드 수정 완료 후 redirectUrl에는 다음 쿼리 파라미터가 전달됩니다.

  • documentId: 수정한 문서 ID
  • eventType: document_modification_completed 또는 document_modification_approval_requested

참고 사항입니다.

  • 링크서명 문서는 내용 수정을 지원하지 않습니다.
  • 수정 중인 문서의 목록 검색 결과는 수정 전 원본 데이터를 기준으로 표시됩니다.
  • PATCH /documents/{documentId}/modification에서 문서 파일을 교체할 때는 POST /files로 업로드한 FileRef만 사용할 수 있습니다.