eSignGlobaleSignGlobal
Центр разработчиков

Скачать файл

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-Срок действия истек

5-Отозвано

downloadUrl

string

URL-адрес для скачивания файла

【Внимание】Действителен в течение 30 минут, по истечении срока действия повторно запросите интерфейс для получения URL-адреса для скачивания

Возвращается, когда downloadType=zip

envelopeFiles

array

Коллекция файлов конверта

Коллекция файлов конверта

【Внимание】Возвращается, когда downloadType=list

 

fileType

string

Тип файла

CONTRACT- Подписанный файл

ATTACHMENT- Вложение

CERTIFICATE- Сертификат

COMBINED- PDF-файл, объединяющий «Подписанный файл» и «Подтверждение завершения подписи», возвращается, когда включена функция «Объединенная загрузка файлов конверта»

 

fileName

string

Имя файла

 

downloadUrl

string

URL-адрес для скачивания файла (действителен в течение 60 минут)

Пример ответа

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