Plataforma para desarrolladores
Con la API de bb-sign, sus sistemas crean y envían sobres, reciben un aviso firmado cada vez que cambia su estado y descargan el documento firmado sin intervención manual. Los SDKs de JavaScript y Java cubren la API y la verificación de webhooks.
URL de producción
Sección titulada «URL de producción»| Valor | |
|---|---|
| URL base de la API | https://sign-api.binarybridges.co |
| URL del token (OAuth2 client credentials) | https://auth.binarybridges.co/realms/bbsign/protocol/openid-connect/token |
| Contrato OpenAPI | https://sign-api.binarybridges.co/v3/api-docs |
| Referencia de la API | /sign/api/ |
Defina las dos primeras como variables de entorno en cada servicio que llame a bb-sign. Un token es válido durante 300 s; ambos SDKs lo obtienen y lo renuevan automáticamente.
Alcance del contrato público
Sección titulada «Alcance del contrato público»La versión 2026-08-09 del contrato tiene 17 rutas (19
operaciones) organizadas en cinco áreas:
| Área | Operaciones | Requiere credencial |
|---|---|---|
| Documentos | Subir un PDF antes de crear el sobre | Sí |
| Sobres | Crear, listar, consultar, adjuntar documentos, agregar firmantes, enviar, cancelar, contar por estado | Sí |
| Ceremonia de firma | Abrir un enlace, solicitar y verificar un código de un solo uso, firmar, descargar la copia firmada, registrar apertura y cierre | No: el token del enlace es la credencial |
| Verificación | Comprobar un sello a partir del código QR de un documento firmado | No |
| Espacios de trabajo | Listar los espacios de trabajo a los que tiene acceso la credencial | Sí |
El token limita cada llamada a la organización de la credencial y, dentro de ella, a sus roles de espacio de trabajo. Autenticación de máquinas explica ambos niveles.
Operaciones de administración
Sección titulada «Operaciones de administración»La gestión de organizaciones, usuarios, certificados, cuotas, credenciales de API, webhooks y espacios de trabajo se realiza en Configuración, a cargo de un administrador de la organización. Las páginas de Administrar la organización describen cada una. Los webhooks, en particular, se registran en Configuración, pestaña Webhooks.