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.