개발자 센터

봉투 전송 뷰 만들기

POST /esignglobal/v1/envelopes/views/sender

인터페이스 설명

봉투 ID를 통해 봉투 발신자 보기를 생성합니다. 개발자는 이 인터페이스를 통해 얻은 페이지를 사용하여 발신자 보기를 타사 애플리케이션에 통합할 수 있습니다.

  1. 이 보기를 통해 시작된 서명 페이지에서 시작된 서명 프로세스는 OAuth의 액세스 토큰에서 구문 분석된 사용자 정보로 채워집니다.
  2. 이 인터페이스를 호출하기 전에 서명 프로세스 생성 인터페이스를 통해 초안 상태의 봉투를 생성해야 합니다.
  3. 서명 프로세스 ID를 생성한 후 서명 파일 추가, 서명자 추가 등 인터페이스를 통해 봉투를 설정할 수 있습니다.
  4. 이 보기에서 생성된 시작 페이지는 iframe 및 웹 보기 포함을 지원하며 페이지 언어는 기본적으로 영어입니다.
  5. 이 인터페이스를 호출하는 것은 서명자의 자동 서명이 포함된 서명 프로세스를 지원하지 않습니다.

요청 매개변수

매개변수 이름

유형

필수 여부

설명

envelopeId

string

true

서명 프로세스 ID, 0-생성됨(초안) 서명 프로세스 ID만 허용

returnUrl

string

true

서명 프로세스 전송 완료 후 리디렉션 주소(길이 2048), https/http 프로토콜 주소를 준수해야 함

settingsobjectfalse전송 페이지 사용자 지정 설정
 startingPagestringfalse 뷰의 시작 페이지를 보냅니다. 기본값은 preparePage입니다.
preparePage - 기본 정보 설정 페이지
taggingPage- 서명 컨트롤 설정 페이지
 submitActionstringfalse 제출, 기본값은 send
save- 저장, 페이지에 save 저장 버튼이 표시되고 send 관련 버튼은 숨겨집니다.
send- 보내기, 페이지에 send now, send, send later 버튼이 표시되고 save 버튼은 숨겨집니다.
 showBackButtonbooleanfalseTagging Page의 뒤로 가기 버튼을 표시할지 여부, 기본값은 true입니다.
true- 표시
false- 표시 안 함
 

lockedArea

arrayfalse

senderView에서 수정할 수 없는 정보, 기본값은 비어 있습니다. 열거 값은 다음과 같습니다.

document - 서명 파일

signerInfo - 서명자 정보

요청 예시

{
    "envelopeId":"75a12f86018040d58e4ba06d6bc9028d",
    "returnUrl":"ggg.fengli.com"
}

응답 매개변수

매개변수 이름

유형

설명

url

string

봉투 시작 페이지 주소

응답 예시

{
    "code": "0",
    "data": {
        "url": "https://app-test-as1.esignglobal-inc.com/document/refine-info?envelopeId=75a12f86018040d58e4ba06d6bc9028d&tcode=...&dc=as1"
    },
    "message": "success"
}

 

인터페이스 설명
요청 매개변수
요청 예시
응답 매개변수
응답 예시