Documentacion de la API de Multi Firmas

Integra la firma digital en tus aplicaciones con nuestra API REST completa. Autenticacion segura, webhooks y SDKs disponibles.

Autenticacion

La API de Multi Firmas utiliza tokens de acceso para autenticar las solicitudes. Puedes generar tokens desde tu panel de administracion en la seccion de API Keys.

Autenticacion por Header

Authorization: Bearer tu_api_key_aqui

Nota: Manten tu API key segura. No la compartas en codigo cliente ni la guardes en repositorios publicos.

Endpoints Principales

POST

/v1/documents

Crear un nuevo documento para firma

GET

/v1/documents/{id}

Obtener detalles de un documento

GET

/v1/documents

Listar todos los documentos

POST

/v1/templates

Crear una nueva plantilla

GET

/v1/templates

Listar todas las plantillas

POST

/v1/clients

Registrar un nuevo cliente

POST

/v1/employees

Registrar un nuevo empleado

Webhooks

Recibe notificaciones en tiempo real cuando un documento es firmado o cambia de estado.

Ejemplo de Webhook

{
  "event": "document.signed",
  "document_id": "doc_abc123",
  "status": "completed",
  "signed_at": "2026-05-15T14:32:15Z",
  "signature_types": ["gps", "photo_face"]
}

Eventos Disponibles

document.created - Nuevo documento creado
document.sent - Documento enviado a firmar
document.signed - Documento firmado completamente
document.expired - Documento expirado sin firmar
document.cancelled - Documento cancelado

SDKs y Librerias

Disponible para los lenguajes mas populares:

Python

pip install multifirmas

JavaScript / Node.js

npm install @multifirmas/sdk

Java

com.multifirmas:sdk:1.0

PHP

composer require multifirmas/sdk

Ejemplos de Codigo

Crear Documento (JavaScript)

JavaScript

const multifirmas = require('@multifirmas/sdk');

const client = new multifirmas.Client('tu_api_key');

const doc = await client.documents.create({
  template_id: 'tpl_recepcion_auto',
  client_id: 'cli_12345',
  signature_types: ['gps', 'photo_face'],
  metadata: {
    order_id: 'ORD-2026-001',
    vehiculo: 'Honda Civic 2023'
  }
});

console.log(doc.sign_url); // URL para que el cliente firme

Crear Documento (Python)

Python

from multifirmas import Client

client = Client('tu_api_key')

doc = client.documents.create(
    template_id='tpl_recepcion_auto',
    client_id='cli_12345',
    signature_types=['gps', 'photo_face'],
    metadata={
        'order_id': 'ORD-2026-001',
        'vehiculo': 'Honda Civic 2023'
    }
)

print(doc.sign_url)  # URL para que el cliente firme

¿Necesitas ayuda con la integracion?

Nuestro equipo de soporte te ayuda a integrar Multi Firmas en tus sistemas.

Solicitar Soporte de Integracion