Análisis

Prioridad entre clientes de una API de multas: cómo se decide

Cuando dos empresas consultan en el mismo minuto y la capacidad no alcanza, alguien define el orden. Conviene que sea una regla escrita y explicable, no el azar del horario en que corre cada cron.

Foto de Enrique OrioneEnrique OrioneCofundador de multas.ar
4 min de lectura
Hilera de sillas de madera vacías alineadas contra una pared clara en un hall con luz natural, con una silla apenas adelantada respecto de la fila.
Hilera de sillas de madera vacías alineadas contra una pared clara en un hall con luz natural, con una silla apenas adelantada respecto de la fila.

Dos empresas consultan en el mismo minuto. Una carga cuatro mil dominios para la conciliación mensual; la otra pide uno solo porque un vehículo se entrega en veinte minutos. Ninguna hace nada indebido y las dos están dentro de su plan. Aun así, alguien decide cuál espera.

Esa decisión existe siempre. Cuando nadie la escribe, la toma el orden de llegada: una regla como cualquier otra, sólo que nadie la eligió y nadie puede explicarle a una flota por qué tardó su consulta. Llamamos prioridad al criterio que ordena el trabajo pendiente cuando la demanda supera la capacidad disponible en una ventana.

Hay un matiz propio de este rubro: buena parte de esa capacidad no es nuestra. Muchas consultas terminan en portales oficiales con su propio ritmo, y agregar servidores no los hace responder más rápido. Acá la prioridad no reparte una máquina elástica, sino el acceso a un recurso ajeno y escaso.

Un solo turno para todos bloquea al más chico

La cola única por orden de llegada tiene una falla conocida: el trabajo grande que entró primero retiene el turno y lo que viene atrás espera, aunque cueste un segundo. Un lote de miles de dominios puede demorar consultas sueltas de otras empresas sin que nadie haya cometido un error.

La corrección es estructural: no compartir la fila. Una cola por cliente y una rotación que atienda una porción acotada de cada una por vuelta. Así un lote de patentes grande tarda más para su dueño —lo esperable— pero no se derrama sobre el resto, y el aislamiento deja de depender de la buena conducta de cada integración.

La clase del trabajo dice más que el tamaño del cliente

Ordenar por cliente no alcanza: dentro de una misma flota conviven urgencias distintas. Conviene entonces declarar la clase del trabajo:

  • interactivo: alguien espera el resultado en pantalla para decidir ahora;
  • programado: un lote con ventana acordada, que puede correr en cualquier momento de ella;
  • de fondo: un rescaneo periódico que nadie está mirando.

La clase informa más que un número de prioridad elegido por el cliente: si declarar urgencia es gratis, todo termina siendo urgente. Cuando la clase interactiva consume un cupo acotado del plan, la declaración vuelve a tener costo y cada empresa la reserva para lo que no puede esperar. Cómo se reparte ese cupo puertas adentro lo tratamos en cuota de consultas.

Admitir y ordenar son decisiones distintas

Aceptar un trabajo y ejecutarlo son dos momentos. Rechazar en la puerta tiene una señal precisa: RFC 6585 define 429 Too Many Requests para indicar que el cliente excedió una política de solicitudes. Esperar detrás de otros no es eso, sino trabajo aceptado con una demora.

Cuando la escasez es del servicio y no del ritmo del cliente, RFC 9110 define 503 para una indisponibilidad temporal y Retry-After para expresar la espera en segundos o como fecha. Ese valor orienta; no reserva un turno.

El motivo conviene entregarlo estructurado. RFC 9457 define un formato de detalles de problema con un tipo legible por máquina, de modo que un ERP distinga “cupo interactivo agotado” de “capacidad de la jurisdicción saturada” sin interpretar texto libre. Los campos RateLimit del borrador del IETF —al cierre de esta verificación sigue siendo un Internet-Draft— permiten bajar el ritmo antes del rechazo; su lectura fina está en rate limits interpretables.

No se publica, en cambio, la posición en la cola: un número de turno permitiría inferir cuántas patentes procesan otras empresas.

Ninguna prioridad puede significar “nunca”

Todo esquema necesita una defensa contra la inanición: el trabajo de menor clase debe correr igual, aunque tarde. Dos mecanismos habituales son el envejecimiento —la espera acumulada aumenta la prioridad efectiva— y un piso de capacidad por clase que las urgencias no pueden absorber.

Hace falta además una espera máxima: al alcanzarla, el trabajo corre o se responde con un estado explícito, pero no queda pendiente en silencio.

Conviene además reservar capacidad para la recuperación: cuando una jurisdicción vuelve después de horas caída, el atraso acumulado compite con el trabajo del día y sin reserva se come la jornada.

Qué verificar en un esquema de prioridad

La prioridad sólo se prueba bajo saturación: con capacidad ociosa cualquier regla parece justa. La verificación usa empresas ficticias —una envía un lote grande, otra una consulta suelta— y mide cuánto espera la chica mientras la grande avanza.

Antes de comprometer un tiempo de respuesta, revisá:

  • que exista una cola por cliente y no una fila compartida;
  • que la clase de trabajo se declare y tenga un cupo acotado;
  • que cada clase tenga piso de capacidad y espera máxima;
  • que el rechazo por ritmo y la demora por turno se distingan en la respuesta;
  • que toda excepción quede registrada con autor, motivo y fecha de fin.

La última es la que más se descuida: cuando un adelantamiento se resuelve a mano, la prioridad termina definiéndola quien tiene el teléfono de alguien del equipo, y eso no se puede auditar.

Preguntas frecuentes

¿Contratar un plan más caro garantiza que mi consulta se atienda primero?

Un plan mayor suele ampliar cupos y capacidad reservada, pero la prioridad ordena trabajo dentro de la capacidad que existe. Si una fuente oficial está saturada o fuera de servicio, ningún plan crea capacidad que no está disponible.

¿Un 429 significa que otra empresa me está desplazando?

No. Ese código indica que las solicitudes propias excedieron una política de ritmo. La demora por orden de atención es otra cosa: el trabajo fue aceptado y espera turno. Conviene que la respuesta permita distinguir los dos casos sin leer texto libre.

¿Por qué no se publica la posición en la cola?

Porque un número de turno o una fila visible permitiría inferir cuánto trabajo están procesando otros clientes. Se informa el estado del trabajo propio y, cuando puede estimarse, una espera orientativa que no describe la carga ajena.

Fuentes consultadas 4 referencias
  1. RFC 9110 — HTTP Semantics (abre en una pestaña nueva) — RFC EditorConsultada el
  2. RFC 6585 — Additional HTTP Status Codes (abre en una pestaña nueva) — RFC EditorConsultada el
  3. RFC 9457 — Problem Details for HTTP APIs (abre en una pestaña nueva) — RFC EditorConsultada el
  4. Internet-Draft activo — RateLimit header fields for HTTP (abre en una pestaña nueva) — Internet Engineering Task ForceConsultada el
Datos y metodología
Alcance de la nota
Criterios para ordenar el trabajo de varios clientes sobre una capacidad compartida y limitada. No cubre la elección de un motor de colas ni la negociación comercial de un acuerdo de nivel de servicio.
Unidad de análisis
Un trabajo encolado, con su cliente de origen, la clase declarada y la espera hasta que se ejecuta.
Cobertura
Semántica de 429, 503, Retry-After y detalles de problema según los RFC citados, más el Internet-Draft activo de campos RateLimit; los pesos y umbrales concretos dependen de cada infraestructura.

Limitaciones

  • Los cupos, pesos y ventanas de rotación deben calibrarse con la capacidad y la latencia reales de cada servicio; esta nota no fija valores.
  • Los campos RateLimit siguen siendo un borrador del IETF y cada proveedor decide si los expone.
  • La capacidad de las fuentes oficiales no se controla desde la integración y puede cambiar sin aviso previo.

Fecha declarada del contenido: . La fecha de consulta no reemplaza la vigencia de la norma ni una revisión independiente.

Notas relacionadas