개발자 센터

파일 다운로드

GET /esignglobal/v1/envelope/files/download

인터페이스 설명

봉투가 완료된 경우에만 봉투 내 파일 다운로드를 지원합니다.

요청 매개변수

매개변수 이름

유형

필수 여부

설명

envelopeId

string

true

봉투 ID

downloadType

stringfalse

파일 다운로드 형식 유형: 

  • zip(기본값): 압축 파일 다운로드 링크 반환
  • list: 파일 목록 반환 

요청 예시

GET https://……/esignglobal/v1/envelope/files/download?envelopeId=flow1234567890&downloadType=list

응답 매개변수

매개변수 이름

유형

설명

envelopeId

string

봉투 ID

envelopeStatus

int

봉투 상태

0-생성됨(초안)

1-서명 중

2-완료됨

3-만료됨

4-거부됨

5-취소됨

downloadUrl

string

파일 다운로드 주소

【주의】30분 이내에 유효하며, 만료 후 인터페이스를 다시 요청하여 다운로드 주소를 받으십시오.

downloadType=zip일 때 반환

envelopeFiles

array

봉투 파일 모음

봉투 파일 모음

【주의】downloadType=list일 때 반환

 

fileType

string

파일 유형

CONTRACT-서명된 파일

ATTACHMENT-첨부 파일

CERTIFICATE-인증서

 

fileName

string

파일 이름

 

downloadUrl

string

파일 다운로드 주소(60분 이내 유효)

응답 예시

{
    "code": "0",
    "data": {
    "envelopeId": "xxxx",
      "downloadUrl": "下载地址",
      "envelopeStatus": 2
  },
  "message": "success"
}

 

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