Desarrolladores
La plataforma completa, también por API.
Emite documentos, crea sobres de firma, escucha eventos por webhooks firmados y embebe la ceremonia en tu propia aplicación. Todo lo que ves en el dashboard existe primero como API.
API REST versionada
- Todo lo que hace el dashboard se puede hacer por API (/api/v1, OpenAPI/Swagger).
- API keys y cuentas de servicio con permisos granulares por clave.
- Multi-tenant estricto: cada clave opera solo sobre su organización.
- Errores consistentes con código, mensaje y correlation ID.
Webhooks firmados
- Eventos del ciclo de vida: acuerdo enviado, firmado, completado, rechazado, expirado…
- Firma HMAC-SHA256 estilo Stripe con protección anti-replay.
- Reintentos con backoff exponencial e idempotencia clasificada.
- Gestión de suscripciones y secretos desde el dashboard o la API.
Firma embebida
- Integra la ceremonia de firma en tu app con un iframe.
- Sesiones efímeras de un solo uso creadas server-side (TTL 15 min).
- Tu app asierta la identidad; Certums registra el acto y la evidencia.
- postMessage al completarse para continuar tu flujo sin recargar.
Verificación programática
- Verificación pública de documentos por CSV y de acuerdos por URL — sin autenticación.
- Expediente de evidencias exportable: se verifica offline con SHA-256, sin depender de Certums.
- Claves públicas Ed25519 publicadas para validar los sellos de plataforma.
- Formularios públicos con firma autoiniciada, listos para enlazar desde tu web.
Ejemplo
# Crear y enviar un acuerdo a firmar
curl -X POST https://api.certums.com/api/v1/agreements \
-H "Authorization: Bearer $CERTUMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Contrato de servicios",
"flowMode": "sequential",
"documents": [{ "documentId": "<docId>", "title": "Contrato" }],
"participants": [
{ "ref": "p1", "role": "signer", "name": "Ana Pérez",
"email": "[email protected]", "order": 1 }
],
"fields": [
{ "type": "signature", "participantRef": "p1", "documentId": "<docId>",
"page": 1, "rect": { "x": 0.55, "y": 0.85, "w": 0.3, "h": 0.07 } }
]
}' ¿Necesitas credenciales de API? Crea tu espacio y genera tus API keys desde el dashboard, o contáctanos para un onboarding asistido.