Guías prácticas
Resuelve flujos completos con cURL, TypeScript y explicaciones de los objetos que devuelve la API.
Elige una guía por la tarea que necesitas resolver. Cada flujo describe los requisitos, las operaciones, los IDs que debes conservar y las comprobaciones antes de continuar.
| Quiero… | Guía |
|---|---|
| Crear mi primer borrador con una firma | Preparar un documento. |
| Reutilizar PDFs y campos preparados | Crear un documento desde una plantilla. |
| Incluir contrato y anexo en el mismo proceso | Un sobre con varios documentos. |
| Iniciar un proceso y archivar el resultado | Distribuir, seguir y descargar. |
| Sincronizar una colección sin consultas excesivas | Paginar y reintentar lecturas. |
Una base común para los ejemplos
Las solicitudes usan https://business.digito.do/api/v2 y el encabezado Authorization con la clave completa del equipo. Configura DIGITO_API_TOKEN en el servidor; nunca la envíes al navegador.
Los ejemplos TypeScript utilizan fetch, FormData y APIs de Node.js; no requieren un SDK. Guarda cada bloque independiente en un archivo .ts y ejecútalo con una versión de Node.js que admita TypeScript. Los tipos locales describen las propiedades consumidas y no validan respuestas externas en ejecución.
Los bloques cURL se ejecutan en una terminal con acceso al mismo secreto. Los PDFs y correos de prueba son sintéticos. Reemplaza IDs solo por valores devueltos a tu integración y revisa antes de distribuir.
Preparación, distribución y firma
Crear un borrador no lo distribuye. Una distribución correcta no confirma una firma completada. Tu servidor debe consultar el sobre y comprobar su resultado antes de archivar.
El firmante se autentica de nuevo con Digito ID antes de cada acción de firma. La sesión en Business, la clave de API y los tokens del flujo no sustituyen esa autenticación. Ningún ejemplo firma en nombre de la persona.
Errores y diagnóstico ayuda a responder a fallos de contenido, alcance o disponibilidad. La referencia contiene los contratos completos para ampliar estos flujos.