Documentação da API
Integre a assinatura eletrônica da Docublock ao seu sistema: crie documentos, colete assinaturas com verificação de identidade e receba eventos em tempo real. Cada assinatura fica ancorada de forma imutável na rede blockchain Corpochain.
URL base
Todas as chamadas são feitas sobre a URL base da API:
| Ambiente | URL base |
|---|---|
| Produção | https://bridge.docublock.co |
| Testes (canary) | https://canary.bridge.docublock.co |
Primeiros passos
1. Obtenha seu token de integração no painel da sua organização em app.docublock.co/organizacion.
2. Inclua-o no cabeçalho Authorization de cada requisição e crie seu primeiro 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. A Docublock notifica automaticamente cada signatário. Quando todos assinam, você recebe o evento document.fully_signed no seu webhook.
Autenticação: todas as rotas (exceto as marcadas como Pública) exigem
Authorization: Bearer <token>. O token está vinculado à sua organização: você não precisa enviar o ID da organização em cada chamada.Convenções
| Tópico | Detalhe |
|---|---|
| Formato | JSON (application/json); os uploads usam multipart/form-data. |
| Tamanho máximo | 100 MB por requisição (suficiente para arquivos em base64). |
| Validação | Campos não reconhecidos → 400. Envie apenas os campos documentados. |
| IDs | ObjectId de 24 caracteres hexadecimais. |
| Paginação | Listagens get-all: { limit, page, order } → { total, totalPages, ... }. |
