Descargar el certificado del sobre
Descarga en PDF el certificado de un documento completado.
/envelope/{envelopeId}/certificate/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/sobre_de_ejemplo/certificate/download' \
--header "Authorization: $DIGITO_API_TOKEN" \
--output './certificado-del-sobre.pdf'Antes de empezar
- Este recurso es un informe PDF asociado a la finalización del sobre. No es el certificado de firma electrónica cualificada del firmante. La firma criptográfica y el certificado de firma electrónica cualificada se verifican en el documento 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 |
|---|---|---|---|---|
envelopeId | Ruta | string | Sí | Identificador del sobre cuyo certificado se descargará. Sin restricciones adicionales en este nivel. |
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-certificate-downloadPdf.