Operaciones
Seguí el estado de las consultas que necesitan más tiempo para completarse.
API v2ActualQué es una operación
Algunas consultas se procesan de forma asincrónica. Cuando eso ocurre, Clasificar devuelve un ID de operación que podés guardar para seguir su estado y obtener el resultado final.
Consultá GET /v2/operations/:id con el ID recibido:
curl 'https://api.clasific.ar/v2/operations/op_92cff723-014a-4b1a-aa26-82bb5287e6aa' \
-H 'x-api-key: <TU_API_KEY>'Consultar una operación no consume consultas de patente ni consultas de módulos. Sí está sujeto al límite de requests por minuto de tu cuenta.
Sólo podés consultar operaciones de tu propia cuenta.
Tipos de operación
kind indica qué consulta dio origen a la operación y dónde leer su resultado.
| kind | Origen | Resultado |
|---|---|---|
| vehicle | Una búsqueda de vehículo que necesitó procesamiento adicional. | result |
| modules | Una consulta de uno o varios módulos. | modules |
La respuesta incluye id, kind, status, plate, createdAt y updatedAt. Las fechas indican cuándo se creó y cuándo se actualizó la operación.
Estados
| Estado | Significado |
|---|---|
| queued | La operación fue aceptada y está esperando comenzar. |
| processing | La operación está siendo procesada. |
| completed | El procesamiento terminó correctamente. |
| partial | El procesamiento terminó con resultados parciales o cobertura reducida. |
| failed | No fue posible completar la operación. |
completed, partial y failed son estados finales. Cuando una operación alcanza uno de ellos, podés dejar de consultar.
Un 200 OK al consultar una operación significa que pudimos recuperar su estado. La operación dentro de la respuesta puede igualmente haber terminado como failed.
Resultado de módulos
En una operación modular, modules contiene el estado y resultado de cada módulo solicitado. Revisá status, data y error de cada uno; también puede incluir warnings.
La operación termina como partial si algún módulo tuvo cobertura reducida o si hubo módulos que fallaron y otros que pudieron responder. Si todos fallaron, termina como failed. Un resultado sin registros puede ser una consulta completada correctamente.
{
"id": "op_92cff723-014a-4b1a-aa26-82bb5287e6aa",
"kind": "modules",
"status": "completed",
"plate": "ZZ000ZZ",
"modules": {
"gnc": {
"status": "completed",
"data": {
"total": 0,
"items": []
},
"error": null
}
},
"createdAt": "2026-09-06T12:00:00.000Z",
"updatedAt": "2026-09-06T12:00:00.000Z"
}Para ver todos los campos y códigos de respuesta, consultá la referencia de API.