API y widget de firma

Con el plan Negocio puedes crear envíos a firmar desde tu programa, tu CRM o tu web, y dejar que tus clientes firmen sin salir de tu página.

Widget para tu web

Pega esta línea donde quieras que aparezca el botón. Al pulsarlo se abre la herramienta de firma en una ventana encima de tu página.

<script src="https://isignyourdoc.com/widget.js" data-modo="firmar" async></script>

¿Prefieres usar tu propio botón? Añade data-isyd-abrir a cualquier enlace o botón de tu web y el widget lo conectará; también puedes abrirlo con iSignYourDoc.abrir().

API REST

URL base: https://isignyourdoc.com/api/v1. Respuestas en JSON. Crea tu clave en el panel → «Tu plan» → API y envíala en cada petición:

Authorization: Bearer isyd_live_…

Crear un envío a firmar

POST /api/v1/envios con un PDF (por URL pública https o en base64). Devuelve el enlace de firma que puedes mandar a tu cliente por correo, WhatsApp o SMS.

curl -X POST https://isignyourdoc.com/api/v1/envios \
  -H "Authorization: Bearer isyd_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "documento_url": "https://tuweb.com/contratos/contrato-123.pdf",
    "nombre_documento": "Contrato 123.pdf",
    "firmante": "cliente@ejemplo.com",
    "firma": { "pagina": -1, "x": 0.55, "y": 0.80, "ancho": 0.35, "alto": 0.08 }
  }'

Respuesta (201):

{
  "id": "s9qk1yp866",
  "estado": "pendiente",
  "firmante": "cliente@ejemplo.com",
  "caduca_el": "2027-10-17T15:33:15Z",
  "enlace_firma": "https://isignyourdoc.com/#firmar=s9qk1yp866",
  "enlace_seguimiento": "https://isignyourdoc.com/#seguir=s9qk1yp866",
  "documentos": [{ "nombre": "Contrato 123.pdf" }],
  "documentos_firmados": []
}

Consultar un envío

GET /api/v1/envios/{id} devuelve el estado (pendiente, visto o firmado) y, cuando está firmado, los enlaces de descarga en documentos_firmados.

Listar envíos

GET /api/v1/envios devuelve tus 50 envíos más recientes.

Ejemplo en JavaScript

const r = await fetch("https://isignyourdoc.com/api/v1/envios", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.ISYD_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ documento_url: urlDelPdf, nombre_documento: "Presupuesto.pdf", firmante: email })
});
const envio = await r.json();
console.log(envio.enlace_firma);

Errores

Guarda tu clave como una contraseña: no la pongas en el código de una página web pública. Si se filtra, revócala en el panel y crea otra.

Preguntas frecuentes