Rubrikea

API para programas

Con la API, otro programa (tu CRM, tu ERP, Zapier o Make) puede preparar y mandar documentos a firmar, consultar cómo van y descargar el PDF firmado. Y Rubrikea puede avisar a ese programa cuando alguien firma. Todo va por HTTPS, con JSON.

1. La clave de acceso

curl https://rubrikea.es/api/templates \
  -H "Authorization: Bearer rbk_TU_CLAVE"

2. Mandar a firmar desde una plantilla (lo más sencillo)

Prepara la plantilla una vez en la aplicación (documento, campos y papeles, por ejemplo «Vendedor» y «Comprador»). Después, por cada contrato:

curl -X POST https://rubrikea.es/api/templates/ID_PLANTILLA/use \
  -H "Authorization: Bearer rbk_TU_CLAVE" -H "Content-Type: application/json" \
  -d '{
    "subject": "Contrato de arras · Calle Mayor 3",
    "people": [
      { "roleId": "ID_PAPEL_VENDEDOR",  "name": "Lucía Pérez", "email": "lucia@ejemplo.es" },
      { "roleId": "ID_PAPEL_COMPRADOR", "name": "Mario Gil",   "email": "mario@ejemplo.es", "idNumber": "12345678Z" }
    ]
  }'

curl -X POST https://rubrikea.es/api/envelopes/ID_ENVIO/send -H "Authorization: Bearer rbk_TU_CLAVE"

idNumber es opcional: si lo pones, el firmante tendrá que escribir ese DNI o NIE antes de firmar.

3. Mandar a firmar un documento nuevo

curl -X PUT https://rubrikea.es/api/envelopes/ID_ENVIO/setup \
  -H "Authorization: Bearer rbk_TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "subject": "Contrato de servicios", "message": "Hola, te lo envío para firmar.",
        "recipients": [ { "name": "Lucía Pérez", "email": "lucia@ejemplo.es", "type": "signer" } ] }'

curl -X PUT https://rubrikea.es/api/envelopes/ID_ENVIO/tabs \
  -H "Authorization: Bearer rbk_TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "tabs": [ { "documentId": "ID_DOCUMENTO", "recipientId": "ID_DESTINATARIO", "type": "signature",
                    "page": 1, "x": 380, "y": 700, "width": 120, "height": 44, "required": true } ] }'

4. Saber cómo va y descargar el firmado

5. Avisos automáticos (webhooks)

En Integraciones pon la dirección de tu programa y elige los avisos. Rubrikea le enviará un POST con JSON cada vez que pase algo:

{ "id": "…", "type": "envelope.completed", "created": "2026-11-18T10:00:00.000Z",
  "data": { "envelopeId": "…", "subject": "Contrato de arras", "status": "completed" } }
// Node.js: comprobar la firma de un aviso
import { createHmac, timingSafeEqual } from "node:crypto";
function avisoValido(cuerpoEnTexto, cabecera, secreto) {
  const partes = Object.fromEntries(cabecera.split(",").map((p) => p.split("=")));
  const esperada = createHmac("sha256", secreto).update(`${partes.t}.${cuerpoEnTexto}`).digest("hex");
  const reciente = Math.abs(Date.now() / 1000 - Number(partes.t)) < 300;
  return reciente && timingSafeEqual(Buffer.from(esperada), Buffer.from(partes.v1 ?? ""));
}

6. Con Zapier o Make, sin programar

Errores

Las respuestas de error llevan { "error": "…" } con el motivo en castellano: 400 (datos no válidos), 401 (falta la clave o no vale), 403 (sin permiso), 404 (no existe o no es tuyo), 409 (no se puede en el estado actual), 429 (demasiadas peticiones).

¿Dudas? Escribe a hola@rubrikea.es.