eSignGlobaleSignGlobal
Centro de desarrolladores

Descargar archivo

GET /esignglobal/v1/envelope/files/download

Descripción de la interfaz

La descarga empaquetada de los archivos del sobre solo está disponible cuando este esté completamente completado.

Parámetros de solicitud

Nombre del parámetro

Tipo

Obligatorio

Descripción

envelopeId

string

true

ID del sobre

downloadType

stringfalse

Tipo de formato de descarga de archivos: 

  • zip (predeterminado): devuelve un enlace de descarga para el archivo comprimido
  • list: devuelve una lista de archivos 

Ejemplo de solicitud

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

Parámetros de respuesta

Nombre del parámetro

Tipo

Descripción

envelopeId

string

ID del sobre

envelopeStatus

int

Estado del sobre

0-Creado (borrador)

1-En proceso de firma

2-Completado

3-Expirado

5-Revocado

downloadUrl

string

URL de descarga del archivo

【Nota】Válido durante 30 minutos. Tras su expiración, vuelva a solicitar la interfaz para obtener la URL de descarga.

Se devuelve cuando downloadType=zip

envelopeFiles

array

Conjunto de archivos del sobre

Conjunto de archivos del sobre

【Nota】Se devuelve cuando downloadType=list

 

fileType

string

Tipo de archivo

CONTRACT-Archivo de firma

ATTACHMENT-Adjunto

CERTIFICATE-Certificado

COMBINED-Archivo PDF que combina el "archivo de firma" y el "comprobante de finalización de la firma", se devuelve cuando está habilitada la opción "descarga combinada de archivos del sobre"

 

fileName

string

Nombre del archivo

 

downloadUrl

string

URL de descarga del archivo (válido durante 60 minutos)

Ejemplo de respuesta

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