Developers
Integra Docublock en tu aplicación.
API RESTful con autenticación por API Key, SDK oficial para JS, Python y PHP, webhooks en tiempo real y documentación completa en inglés y español.
Quick start
Tu primera firma en 5 minutos
Crea tu primera solicitud de firma programáticamente.
1. Crear un sobre de firma
create-envelope.js
const docublock = require('@docublock/sdk');
const client = new docublock.Client({
apiKey: 'dk_live_your_api_key_here'
});
const envelope = await client.envelopes.create({
title: 'Contrato de servicios',
documents: [{
name: 'contrato.pdf',
base64: '<base64_del_pdf>'
}],
signers: [{
name: 'Carlos Gómez',
email: 'carlos@empresa.co',
order: 1
}],
options: {
blockchain: true,
identity_verification: 'otp',
expiry_days: 7
}
});
console.log(envelope.id);
// env_2xKd9mQpLr4vNz2. Escuchar el webhook de firma completada
webhook-handler.js
// Express.js webhook handler
app.post('/webhook/docublock', (req, res) => {
const { event, data } = req.body;
const isValid = docublock.webhooks.verify(
req.headers['x-docublock-signature'],
req.rawBody,
process.env.WEBHOOK_SECRET
);
if (!isValid) return res.status(401).send();
switch (event) {
case 'envelope.completed':
console.log('Todos firmaron:', data.envelope_id);
console.log('TX blockchain:', data.blockchain_tx);
break;
case 'document.signed':
console.log('Firmó:', data.signer.name);
break;
}
res.status(200).send('ok');
});API REST
Endpoints de la API
API base URL: https://api.docublock.co/v1
POST/envelopesCrear un sobre con documentos y firmantes
POST/envelopes/{id}/signersAgregar firmantes a un sobre existente
GET/envelopes/{id}Consultar el estado de un sobre y sus firmas
POST/documents/verifyVerificar la autenticidad de un documento
GET/documents/{id}/certificateDescargar el certificado blockchain de un documento
DELETE/envelopes/{id}Cancelar un sobre antes de que sea firmado
SDKs
SDKs oficiales
Instala el SDK para tu lenguaje y empieza en minutos.
Oficial
JavaScript / TypeScript
npm install @docublock/sdk
Oficial
Python
pip install docublock-sdk
Oficial
PHP
composer require docublock/sdk
Webhooks
Eventos en tiempo real
Recibe notificaciones en tu servidor para cada evento relevante.
envelope.sent
Un sobre fue enviado a los firmantes
envelope.viewed
Un firmante abrió el sobre
document.signed
Un firmante completó su firma
envelope.completed
Todos los firmantes han firmado
envelope.expired
El plazo del sobre venció
signer.bounced
El email de un firmante rebotó
¿Necesitas ayuda con la integración?
Nuestro equipo de soporte developer está disponible para ayudarte con la integración, revisar tu código y resolver dudas técnicas.
