Documentación de la API
Integra la firma electrónica de Docublock en tu sistema: crea documentos, recoge firmas con verificación de identidad y recibe eventos en tiempo real. Cada firma queda anclada de forma inmutable en la red blockchain Corpochain.
URL base
Todas las llamadas se hacen sobre la URL base de la API:
| Entorno | URL base |
|---|---|
| Producción | https://bridge.docublock.co |
| Pruebas (canary) | https://canary.bridge.docublock.co |
Primeros pasos
1. Obtén tu token de integración desde el panel de tu organización en app.docublock.co/organizacion.
2. Inclúyelo en el encabezado Authorization de cada petición y crea tu primer documento:
bash
curl -X POST https://bridge.docublock.co/api/documents/create-pdf-base64 \
-H "Authorization: Bearer <TU_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"name": "Contrato #1024",
"baseFile": "JVBERi0xLjcK...==",
"filename": "contrato.pdf",
"endorsementInput": [{
"firstName": "María", "lastName": "Ríos",
"identification": "1019234567", "identificationKind": "CC",
"kindPerson": "Persona Natural",
"email": "maria@ejemplo.com", "cellphone": "+573001112233",
"country": "661a1fb2a0e9e20423fe6cc8",
"principalSigner": true, "iteration": 1
}]
}'3. Docublock notifica automáticamente a cada firmante. Cuando todos firman, recibes el evento document.fully_signed en tu webhook.
Autenticación: todas las rutas (salvo las marcadas como Pública) requieren
Authorization: Bearer <token>. El token está atado a tu organización: no necesitas enviar el ID de la organización en cada llamada.Convenciones
| Tema | Detalle |
|---|---|
| Formato | JSON (application/json); las cargas usan multipart/form-data. |
| Tamaño máximo | 100 MB por petición (suficiente para archivos en base64). |
| Validación | Campos no reconocidos → 400. Envía solo los campos documentados. |
| IDs | ObjectId de 24 caracteres hexadecimales. |
| Paginación | Listados get-all: { limit, page, order } → { total, totalPages, ... }. |
