Descargar un archivo
Descarga un elemento de documento por su identificador y la versión solicitada.
/envelope/item/{envelopeItemId}/downloadURL base: https://business.digito.do/api/v2.
Ejemplos
Configura DIGITO_API_TOKEN en el servidor. Sustituye los IDs y archivos de ejemplo por los de tu equipo. TypeScript usa fetch y FormData de Node.js.
curl --fail-with-body \
--request GET \
--url 'https://business.digito.do/api/v2/envelope/item/archivo_de_ejemplo/download?version=signed' \
--header "Authorization: $DIGITO_API_TOKEN" \
--output './documento-firmado.pdf'Antes de empezar
versionaceptaoriginal,signedypending; el contrato indicasignedcomo valor predeterminado.pendingsolo corresponde a sobresPENDINGy contiene los campos insertados hasta ese momento. No representa un documento final firmado.
Autenticación
Envía el token de la API en el encabezado Authorization. El acceso corresponde al equipo y a los permisos del token. Conserva el token en tu servidor.
Authorization: api_TU_TOKENAntes de cada acción de firma, el firmante debe autenticarse de nuevo con Digito ID. Una sesión previa de Business, un token de destinatario o un token de la API no sustituye este requisito.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Restricciones |
|---|---|---|---|---|
envelopeItemId | Ruta | string | Sí | Identificador del elemento de documento que se descargará. Sin restricciones adicionales en este nivel. |
version | Consulta | string | No | Versión del archivo: signed devuelve el documento completado con sus firmas y auditoría; original devuelve el archivo original; pending devuelve el archivo con los campos insertados hasta ese momento, únicamente mientras el sobre está PENDING. pending no representa un documento final firmado. Valores: "original", "signed", "pending". Predeterminado: "signed" |
Cuerpo de la solicitud
Esta operación no declara cuerpo de solicitud.
Respuesta de éxito
La respuesta 200 contiene un archivo PDF. cURL lo guarda con --output; TypeScript escribe los bytes obtenidos mediante arrayBuffer(). El contrato declara Content-Type: application/pdf, aunque el esquema del cuerpo aparece vacío bajo application/json.
Respuestas y errores
| Estado | Descripción | Contenido y esquema |
|---|---|---|
200 | Respuesta correcta. | application/json |
400 | Datos de entrada inválidos. | application/json |
401 | No se proporcionó autorización. | application/json |
403 | Permisos insuficientes. | application/json |
404 | Recurso no encontrado. | application/json |
500 | Error interno del servidor. | application/json |
Los esquemas enlazados incluyen propiedades anidadas, campos obligatorios, variantes, enumeraciones, nulabilidad y restricciones. Consulta errores y reintentos para manejar respuestas no exitosas.
Encabezados de la respuesta 200
| Encabezado | Tipo | Obligatorio | Restricciones |
|---|---|---|---|
Content-Type | string | Sí | Valores: "application/pdf" |
Identificador de operación: envelope-item-download.