Digito Business API
De una primera solicitud a tu flujo de documentos: guías prácticas, ejemplos en cURL y TypeScript y referencia de la API.
Integra la preparación, distribución y seguimiento de documentos con tu aplicación. La API trabaja con sobres: cada sobre reúne PDFs, destinatarios y campos, y pertenece al equipo de tu clave.
Haz tu primera solicitud
Guarda una clave de API del equipo en DIGITO_API_TOKEN en el servidor. Esta consulta lista documentos sin modificar datos:
curl --fail-with-body --get \
'https://business.digito.do/api/v2/envelope' \
-H "Authorization: $DIGITO_API_TOKEN" \
--data-urlencode 'type=DOCUMENT' \
--data-urlencode 'perPage=10'Usa siempre la base https://business.digito.do/api/v2. Tu primera solicitud explica la respuesta, el alcance por equipo y los siguientes pasos. La clave permanece en el servidor; tu frontend recibe solo los datos que su usuario puede consultar.
Construye tu primer flujo
Conecta el equipo correcto
Autenticación explica el encabezado Authorization. Acceso por equipo te ayuda a relacionar claves y recursos con tu organización.
Prepara un borrador revisable
Crea un documento con PDF, firmante y campo, o reutiliza una plantilla para generar un documento con datos nuevos. Guarda el ID devuelto y conserva el borrador para revisión.
Distribuye y sigue el proceso
Distribuir, seguir y descargar separa el inicio del proceso de su confirmación. Consulta el estado desde tu servidor y evita interpretar una apertura como firma completada.
Archiva el resultado y su evidencia
Tras confirmar COMPLETED, descarga el PDF final de cada elemento y conserva auditoría e informes del proceso según las necesidades de tu aplicación.
Elige tu siguiente tarea
Contrato y anexo
Prepara varios PDFs en un sobre y relaciona cada campo con su documento.
Sincronización fiable
Recorre páginas y maneja fallos temporales con TypeScript, sin duplicar escrituras.
Integración en tu aplicación
Separa la autorización de tu servidor, la preparación y la acción de la persona firmante.
Referencia de operaciones
Consulta métodos, rutas, parámetros, cuerpos, respuestas y esquemas del contrato vigente.
Comprende los recursos
| Recurso | Para qué sirve |
|---|---|
| Sobres | Reúnen el proceso y su estado; DOCUMENT para documentos y TEMPLATE para plantillas. |
| Archivos PDF | Elementos de envelopeItems que reciben campos y se descargan por ID. |
| Destinatarios | Personas, funciones y progreso del proceso. |
| Campos | Zonas y datos del PDF asignados a una persona. |
| Adjuntos y carpetas | Links de apoyo y organización dentro del equipo. |
Los ejemplos conservan los identificadores reales del contrato y explican su uso en español. Usa clientes HTTP si prefieres TypeScript, Python o Go. Este portal muestra código; no ejecuta solicitudes a tu cuenta.
La clave de API y la firma son autorizaciones distintas
El firmante se autentica de nuevo con Digito ID antes de cada acción de firma. Una sesión en Business, una clave de API, un token de destinatario o un token de integración no sustituye esa autenticación. Tu integración prepara y sigue el proceso; la persona autoriza su firma.