Lo que enviamos en enero de 2026

Enero ha sido un mes muy ocupado. Hemos lanzado un montón de actualizaciones en Firma.dev que nos entusiasman bastante, y la mayoría de ellas provienen directamente de los comentarios que recibimos de los desarrolladores que construyen sobre la API.

El tema de este mes ha sido hacer la API más rápida, más flexible y más fácil de integrar. Algunos de estos cambios son pequeñas mejoras en la calidad de vida. Otros abren flujos de trabajo completamente nuevos. Ahora estamos en la versión 1.2.0, y todo lo que se muestra aquí ya está disponible.

Aquí está el resumen.

Solicitudes de firma un 40 % más rápidas

Pasamos un par de semanas analizando el rendimiento y logramos reducir la latencia promedio de nuestras solicitudes de firma de 820 ms a unos 500 ms. Eso es aproximadamente una mejora del 40 % en general.

Los cambios fueron principalmente trabajos de infraestructura. Limpiamos algunas consultas de bases de datos que se habían vuelto ineficientes con el tiempo y movimos los activos estáticos detrás de AWS CloudFront para el almacenamiento en caché perimetral. Nada revolucionario, pero es el tipo de trabajo que se acumula.

Si está integrando firmas en su producto, esto importa más de lo que parece. 300 ms de latencia no parece mucho, pero es la diferencia entre un flujo de firma que se siente instantáneo y uno que se siente lento. Las respuestas más rápidas significan menos flujos abandonados y menos fricción para sus usuarios.

Solicitudes de firma únicas (no se requiere plantilla)

Anteriormente, si deseaba enviar un documento para su firma a través de Firma.dev, primero tenía que crear una plantilla. Eso tenía sentido para flujos de trabajo repetibles como contratos de trabajo o acuerdos de confidencialidad, pero añadía pasos innecesarios para documentos de una sola vez.

Ahora puede omitir la plantilla por completo. Suba un PDF directamente, defina sus campos y destinatarios en línea y envíelo. Una sola llamada a la API, sin necesidad de crear plantillas.

Esto es útil para acuerdos ad-hoc, contratos únicos o cualquier situación en la que no vaya a reutilizar la estructura del documento. Sigue teniendo los mismos tipos de campos, opciones de firmante y seguimiento. Simplemente no tiene que configurar una plantilla primero.

Consulte el endpoint de creación de solicitudes de firma para obtener detalles de implementación.

Endpoint atómico de creación + envío

Hablando de reducir las llamadas a la API: agregamos un nuevo endpoint atómico que le permite crear y enviar una solicitud de firma en una sola llamada.

Anteriormente, llamaría al endpoint de creación y luego al de envío. Dos solicitudes, dos viajes de ida y vuelta. El nuevo endpoint /signing-requests/create-and-send combina ambos en uno solo.

Pero el beneficio real es la integridad transaccional. El endpoint valida todo antes de crear cualquier cosa. Si algo falla en la validación, no se crea nada y no se le cobra. Los créditos solo se deducen después de que la solicitud de firma se crea con éxito y se envían los correos electrónicos.

De la documentación: "Llamada única a la API en lugar de dos solicitudes separadas... Deducción de crédito atómica: solo cobra si todo tiene éxito".

Si está creando automatizaciones o flujos de trabajo de gran volumen, este endpoint es más limpio y confiable que encadenar dos llamadas.

Campos de solo lectura

Ahora puede marcar los campos como de solo lectura al crear o actualizar una solicitud de firma. Estos son campos que aparecen en el documento con valores precargados, pero que el firmante no puede editar.

Esto es útil para cosas como montos de contratos, números de referencia, totales calculados o identificaciones de empleados. Cualquier cosa que el firmante necesite ver para el contexto pero que no debería poder cambiar.

Encontrará la propiedad read_only en el endpoint de actualización integral. Establézcala en true en cualquier campo de texto y se volverá visible pero no editable.

Controles de correo electrónico granulares

Agregamos cuatro configuraciones nuevas que le brindan un control detallado sobre qué correos electrónicos envía Firma.dev en su nombre:

• send_signing_email: la notificación inicial de "por favor, firme este documento"

• send_finish_email: la confirmación de "firma completada"

• send_expiration_email: el recordatorio cuando una solicitud está a punto de vencer

• send_cancellation_email: la notificación cuando se cancela una solicitud

Los cuatro están configurados de manera predeterminada en true, por lo que las integraciones existentes funcionan exactamente igual que antes. Pero si desea enviar sus propios correos electrónicos de marca en lugar de los nuestros, ahora puede desactivar cualquiera de ellos o todos y gestionar las notificaciones usted mismo.

Esto se complementa muy bien con las configuraciones de marca blanca a continuación.

Omitir los términos de Firma.dev para una marca blanca completa

Hay una nueva configuración en su espacio de trabajo llamada "Requerir aceptación de términos". Cuando está habilitada (por defecto), los firmantes tienen que aceptar los términos y condiciones de Firma.dev antes de firmar. Cuando la deshabilita, ese paso desaparece por completo.

Esto está diseñado para equipos que desean una experiencia de firma de marca blanca completa. Sus firmantes ven su marca, sus correos electrónicos (si ha desactivado los nuestros) y sus términos. Firma.dev permanece invisible.

If decide tomar este camino, le recomendamos que tenga sus propios términos y condiciones vigentes. Está asumiendo la responsabilidad de informar a los firmantes sobre las implicaciones legales de su firma, así que asegúrese de que sus propios términos y condiciones cubran eso.

Combinado con los controles de correo electrónico anteriores, ahora puede ejecutar una experiencia de firma completamente personalizada sin que se muestre ninguna interfaz de usuario de Firma.dev a sus usuarios finales.

Nuevas guías para desarrolladores

Reescribimos gran parte de nuestra documentación este mes. Se publicaron tres guías nuevas:

Guía de autenticación: cubre la autenticación con clave API para solicitudes de servidor a servidor, además de tokens JWT para integrar los editores de plantillas y solicitudes de firma en su aplicación. También incluye el nuevo flujo de rotación de claves API con períodos de gracia de 24 horas.

Guía de límites de velocidad: documenta todos los niveles de límites de velocidad (200 solicitudes/min para lecturas, 120/min para escrituras, etc.). Nota importante aquí: los límites de velocidad son por espacio de trabajo, y puede tener espacios de trabajo ilimitados en su cuenta. Eso le brinda una escalabilidad horizontal efectivamente ilimitada. Si por alguna razón necesita límites aún más altos para un caso de uso específico, comuníquese con soporte y podemos aumentarlos, pero los valores predeterminados ya están diseñados para volúmenes muy altos.

Guía de configuración completa: un recorrido completo de extremo a extremo desde la creación de la cuenta hasta la firma integrada. Cubre espacios de trabajo, plantillas, solicitudes de firma, editores integrados, webhooks y gestión de créditos. Si recién está comenzando, este es el lugar para comenzar.

Versionado completo de la API

Este mes introdujimos un sistema de versionado formal. La API ahora utiliza un versionado basado en encabezados a través del encabezado X-API-Version, y actualmente estamos en la v1.2.0.

La versión corta: nos comprometemos a no romper su integración. De la guía de versionado: "Los cambios disruptivos solo se introducen en incrementos de versiones principales... Los cambios no disruptivos, como nuevos campos opcionales o nuevos endpoints, no requieren una nueva versión".

Cuando finalmente lancemos una v2, la versión anterior no desaparecerá simplemente. Recibirá advertencias de obsolescencia en los encabezados de respuesta durante al menos seis meses antes de que se retire por completo. Los encabezados siguen la norma RFC 8594, por lo que si ya está buscando encabezados de Deprecation y Sunset en otras API, sabrá qué esperar.

Por ahora, la v1 está activa y no hay obsolescencia programada. Todo lo que lanzamos este mes es adicional, por lo que su integración existente sigue funcionando sin cambios.

Resumen

Eso es todo por enero. Muchas mejoras pequeñas y medianas que se suman para ofrecer una API más capaz y flexible.

Los precios no han cambiado. Siguen siendo de €0,049 por sobre, pago por uso, sin mínimos. Si aún no ha probado Firma.dev, puede realizar pruebas con documentos reales de forma gratuita, sin límites, y solo pagar cuando se lance en producción.

Seguiremos lanzando novedades. Si hay algo que le gustaría ver en la API, háganoslo saber.

Comience gratis: no se requiere tarjeta de crédito.