Saltar al contenido principal

Quickstart: Firma de documentos por API en la nube

Este Quickstart muestra cómo firmar un documento PDF utilizando la API de Firma Digital en la Nube de Lakaut AC, de forma remota y segura.

Al finalizar, vas a comprender el flujo básico de integración y los endpoints principales involucrados.

¿Qué permite esta integración?

La API de Firma en la Nube permite que los usuarios finales firmen documentos PDF sin necesidad de dispositivos físicos, utilizando:

  • Autenticación centralizada
  • Segundo factor de autenticación (OTP)
  • Claves privadas protegidas en un HSM en la nube

Flujo básico de firma

El proceso de firma por API sigue estos pasos:

  1. El usuario se autentica y obtiene un token JWT
  2. Se consultan las solicitudes de firma disponibles
  3. Se configuran los parámetros de la firma
  4. Se envía el documento para firmar
  5. Se obtiene el documento firmado

Este flujo se ejecuta completamente a través de la API.

Endpoints principales

Durante el proceso de firma se utilizan los siguientes endpoints:

  • GET /solicitudes
    Obtiene las solicitudes de firma disponibles para el usuario autenticado.

  • POST /solicitudes/firmar
    Envía el documento y los parámetros necesarios para aplicar la firma digital.

Autenticación

La API utiliza autenticación basada en JWT.

El token debe incluirse en cada request mediante el header:

Authorization: Bearer <jwt_token>

La obtención del token se realiza a través de un sistema de autenticación centralizado con doble factor (OTP).

Resultado del proceso

Una vez completado el flujo:

  • El documento queda firmado digitalmente
  • Se obtiene una respuesta con el PDF firmado
  • El archivo puede ser descargado o almacenado por el cliente

Próximos pasos

Este Quickstart muestra únicamente el flujo básico.

Para una implementación completa, consultá las siguientes secciones del sitio:

  • Guía práctica: Firma por API en la nube
    Explicación detallada paso a paso del proceso de integración.

  • API Reference
    Documentación completa de los endpoints, parámetros y respuestas.

  • Demo oficial
    Aplicación de ejemplo para probar el flujo completo de firma.