Polling

Flujo de consulta#

Guardá el id recibido al crear la consulta y reutilizalo para leer su estado. Los reportes usan IDs rep_ y los módulos usan vmq_.

Comprobá los estados terminales completed y failed. No uses un número fijo de consultas como criterio para dar una operación por terminada.

Requests#

Reemplazá el ID del ejemplo por el que devolvió la creación. Estas consultas de estado no consumen cuota del plan.

curl "https://api.clasific.ar/v1/reports/rep_8d2c7ef49d8b4c8fa27d1d8906229341" \
  -H "x-api-key: $CLASIFICAR_API_KEY"

const apiKey = process.env.CLASIFICAR_API_KEY;
if (!apiKey) throw new Error("Falta CLASIFICAR_API_KEY");

const response = await fetch(
  "https://api.clasific.ar/v1/reports/rep_8d2c7ef49d8b4c8fa27d1d8906229341",
  {
    headers: {
      "x-api-key": apiKey,
    },
  },
);

if (!response.ok) {
  throw new Error(
    `HTTP ${response.status}: ${await response.text()}`,
  );
}

const result: unknown = await response.json();
console.log(result);

Reintentos#

Como estrategia de cliente, espaciá las consultas y aumentá la espera ante fallas transitorias. Respetá los rate limits y cancelá el polling cuando llegue un estado terminal. V1 no publica aquí una frecuencia obligatoria.

Si perdés la respuesta de creación, reintentá esa creación con la misma Idempotency-Key. Hacer polling y volver a crear una consulta son acciones distintas.