SignSolú
Operación

120 peticiones por minuto y 10,000 al día: cuántos documentos caben en una API de firma

9 min de lectura

Muchos más de los que parece, porque un documento no cuesta una petición y la mayoría de las peticiones que gasta una integración no son del envío: son de preguntar si ya firmaron. Con los topes publicados de SignSolú —120 peticiones por minuto y 10,000 al día por llave real, 30 por minuto en prueba— un documento bien integrado cuesta unas tres peticiones, así que el tope diario da para miles de documentos. El mismo documento, con una integración que consulta el estado cada cinco minutos durante dos días, cuesta cerca de seiscientas. Ahí se va el presupuesto, y por eso la pregunta útil no es cuántos documentos caben sino cuántas peticiones gasta cada uno.

La pregunta llega siempre en la misma forma, antes de escribir una línea de integración: «mandamos tantos contratos al mes, ¿nos alcanza?». Y la respuesta que se encuentra publicada nunca contesta, porque los topes se publican en una unidad —peticiones por minuto— y la operación se cuenta en otra —documentos al mes—. Lo que sigue es cómo se convierte una en la otra, con los topes que SignSolú tiene publicados. Si lo que estás decidiendo es más atrás, si firmar dentro de tu producto o mandar a la gente a otro lado, eso está en firmar dentro de tu sistema o en una plataforma aparte.

Los dos números, y cuál de los dos manda

Los topes publicados son 120 peticiones por minuto y 10,000 peticiones al día por llave real, y 30 por minuto en modo de prueba. Al pasarse, la respuesta es un 429 con Retry-After, que es el servidor diciendo cuánto esperar. Están en la guía para desarrolladores junto con los permisos de cada llave.

Fíjate en la unidad: peticiones, no documentos. Una petición es una llamada a la interfaz. Crear el documento es una. Preguntar si ya lo firmaron es otra. Preguntarlo otra vez, media hora después, es una tercera, aunque no haya pasado nada. El tope no distingue entre la llamada que hace algo y la que sólo pregunta, y ésa es toda la historia.

Cuánto cuesta un documento, llamada por llamada

Un documento que nace en tu sistema, se manda a firma y regresa firmado pasa por estos pasos. No todos los sistemas los hacen igual, pero el esqueleto es éste:

  1. 1Crear el documento con sus firmantes y su referencia propia. Una petición.
  2. 2Mandarlo a firma. Una petición, o ninguna si se manda en el mismo paso.
  3. 3Enterarse de que se firmó. Aquí es donde se decide todo.
  4. 4Descargar el documento firmado y su certificado de auditoría. Una petición.

Los pasos uno, dos y cuatro son fijos: tres peticiones por documento, más o menos, y no hay forma de bajarlos mucho. El paso tres no es fijo. Es el que puede costar cero o puede costar seiscientas, y la diferencia es si tu sistema pregunta o si le avisan.

Preguntar cada rato es lo que se come el presupuesto

Supón que un documento tarda dos días en firmarse, que es un plazo normal cuando del otro lado hay una persona. Si tu sistema consulta el estado cada cinco minutos durante esos dos días, son 576 consultas por documento. Cada una devuelve lo mismo —«sigue pendiente»— salvo la última. Si consulta cada hora, son 48. Si recibe un aviso cuando alguien firma, son cero.

Ese aviso es el webhook: una llamada que SignSolú le hace a tu sistema, firmada, cuando el documento cambia de estado. No cuenta contra tu tope porque la petición no la haces tú. Es, de lejos, la decisión que más cambia la cuenta, y no es una optimización avanzada: es la forma normal de integrarse.

Peticiones que gasta un documento que tarda dos días en firmarse, según cómo se entera el sistema: 3 peticiones con webhooks, 51 consultando el estado cada hora y 579 consultando cada cinco minutos
El mismo documento, tres integraciones. Lo que cambia es el paso de enterarse.

La cuenta completa, con los dos topes

Con el costo por documento en la mano, el tope diario se convierte en documentos dividiendo. Los números de abajo salen de los topes publicados y del supuesto de arriba —dos días para firmar—, no de una medición de nadie:

Cómo se entera tu sistemaPeticiones por documentoDocumentos al día dentro del tope de 10,000
Webhook firmado3Unos 3,300
Consulta cada hora51Unos 196
Consulta cada 5 minutos579Unos 17
Dos días de espera por documento, topes publicados de 10,000 peticiones al día por llave real. Los supuestos son para hacer la cuenta, no datos de operación de nadie.

Mírese el último renglón: una integración que consulta cada cinco minutos topa a los diecisiete documentos al día. No porque la plataforma aguante poco, sino porque gastó el presupuesto preguntando. Ése es el escenario que produce la llamada de «su API nos limita», y la causa está del lado de quien integró.

El tope por minuto es otra cosa, y casi nunca es el problema

Los 120 por minuto no limitan cuánto haces al día: limitan qué tan concentrado lo haces. Mandar 500 documentos a las siete de la tarde son unas 1,000 peticiones en un rato, y a 120 por minuto eso son unos ocho minutos de llamadas sostenidas. No es un problema si se reparten; sí lo es si se lanzan todas juntas, y entonces llegan los 429. Cómo se prepara una ráfaga de verdad está contado en fin de mes en una financiera.

El techo que sí te va a tocar primero

Aquí conviene decir lo que el cálculo anterior esconde: para la mayoría de las integraciones, el tope de peticiones no es el primero que se alcanza. El primero es el de documentos de tu plan. El plan de paga de SignSolú son $399 MXN al mes con 200 documentos, usuarios ilimitados y plantillas ilimitadas, y un documento creado por la interfaz cuenta igual que uno creado en el panel. Cada documento cuenta una vez, firmen cuantos firmen.

Doscientos documentos al mes son menos de diez al día. Contra eso, cualquiera de los tres renglones de la tabla alcanza. Arriba de 200 al mes hay plan a la medida y bolsa para el equipo, y ahí se escribe con el volumen y las sedes. O sea que la conversación de capacidad casi siempre empieza por el lugar equivocado: no es cuántas peticiones, es cuántos documentos salen al mes de tu operación. La cuenta general está en cuánto cuesta firmar contratos en línea en México, qué trae el plan gratis en firma electrónica gratis: qué obtienes y qué no, quién paga qué en quién paga la firma, y el panorama de producto, en la API de firma electrónica y para empresas.

Cómo se mide esto antes de contratar

No hace falta estimar nada: se mide con tu propio volumen y gratis. Cualquier cuenta, también la gratis, crea llaves de prueba. Con ellas todo funciona igual que en producción, pero los documentos llevan marca de agua, no descuentan de tu plan y se borran solos a los 30 días. El tope en prueba es más bajo a propósito —30 peticiones por minuto— justamente para que una integración ruidosa se note ahí y no en producción.

  • Cuenta las peticiones que tu integración hace por documento, de punta a punta, incluidas las consultas de estado.
  • Multiplica por los documentos que de verdad mandas al día, no por el pico imaginario.
  • Si el resultado se acerca a 10,000, el problema casi siempre es el paso de enterarse: cámbialo por webhooks antes de pedir más tope.
  • Revisa aparte cuántos documentos al mes son, porque ése es el número que decide tu plan.
  • Prueba con una llave de prueba y mira el reporte antes de mandar un contrato real.

Y una cosa que no es de capacidad pero decide más que ella: el documento no se firma cuando tu sistema lo manda, sino cuando una persona lo abre. Lo que hace que eso pase antes está en cuando el cliente no firma: recordatorios que funcionan y, si el envío sale de una hoja de cálculo, en contratos masivos desde Excel. Cuánto tarda de verdad un contrato en firmarse, medido, está en cuánto tarda firmar un contrato electrónico en México.

Tres cosas que la cuenta de arriba no dice

Las peticiones que fallan también cuentan

Un 429 es una petición. Una petición con un dato mal formado también. Una integración que reintenta sin esperar convierte un tope rebasado en una espiral: cada reintento consume presupuesto y acerca el siguiente rechazo. Por eso el reintento se hace con la espera que indica Retry-After y creciendo, no de inmediato, y por eso conviene que el reintento sea seguro: con la misma Idempotency-Key no nace un documento nuevo.

Las descargas pesan distinto

Descargar el documento firmado y su certificado son peticiones como cualquier otra para el tope, pero tardan más que una consulta de estado. Si tu sistema descarga todo el histórico cada noche «por si acaso», ésa es una tarea que puede gastar más presupuesto que toda la operación del día. Se descarga una vez, cuando llega el aviso de firmado.

Las llaves se cuentan por separado

Los topes son por llave real. Un sistema que ya tiene su propia llave no le quita presupuesto a otro, y eso es un argumento más para no tener una sola llave compartida entre cuatro sistemas. La lista completa de lo que conviene revisar antes de integrar está en qué revisar en la API de firma antes de integrarla, y si algún día te mudas, qué tienes que llevarte está en cambiar de plataforma de firma.

Lo que queda de cada documento, pase por donde pase

Un documento creado por la interfaz sale con la misma evidencia que uno creado a mano: certificado de auditoría con hora, dirección IP, dispositivo y huella SHA-256, verificable por cualquiera en /verificar sin cuenta —cómo se comprueba, paso a paso, en cómo se verifica que un documento firmado no fue alterado—. Y SignSolú emite la constancia de conservación NOM-151 del documento firmado a través de un Prestador de Servicios de Certificación acreditado por la Secretaría de Economía; los planes de paga incluyen 20 al mes. Qué acredita, en qué es la constancia de conservación NOM-151; qué trae el acuse, en qué es un acuse de auditoría y qué debe traer; y el respaldo legal, en el Código de Comercio.

De dónde salen las citas

Preguntas frecuentes

¿120 peticiones por minuto son 120 documentos por minuto?

No. Una petición es una llamada a la interfaz, y un documento cuesta varias: crearlo, mandarlo, enterarse de que se firmó y descargarlo. Un documento bien integrado cuesta alrededor de tres peticiones; uno que se consulta cada cinco minutos durante dos días cuesta cerca de seiscientas.

¿Qué se gasta más peticiones, mandar o consultar?

Consultar, con mucha diferencia. Mandar un documento cuesta una o dos peticiones y ocurre una sola vez. Consultar el estado ocurre mientras el documento esté pendiente, que suelen ser días. Si el sistema recibe un webhook firmado en lugar de preguntar, ese renglón cuesta cero.

¿Qué pasa si paso el tope?

La respuesta es un 429 con Retry-After, que indica cuánto esperar antes de volver a intentar. Un reintento con la misma Idempotency-Key no crea un documento nuevo, así que volver a llamar después de la espera es seguro y no duplica nada.

¿Los documentos de prueba cuentan contra el tope o contra mi plan?

Las llaves de prueba tienen su propio tope, más bajo: 30 peticiones por minuto. Los documentos de prueba llevan marca de agua, no descuentan documentos de tu plan, no mandan correos y se borran solos a los 30 días.

¿Cuál tope voy a alcanzar primero?

Casi siempre el de documentos de tu plan, no el de peticiones. El plan de paga son 399 pesos al mes con 200 documentos, que son menos de diez al día; a ese ritmo el tope de 10,000 peticiones diarias no se acerca. Arriba de 200 documentos al mes hay plan a la medida.

Sigue leyendo

Prueba SignSolú con 10 documentos gratis