Quickstart

1. Consultá un vehículo#

Usá la patente directamente en la URL:

curl 'https://api.clasific.ar/v2/vehicles/ZZ000ZZ' \
  -H 'x-api-key: <TU_API_KEY>'

La respuesta contiene la información básica disponible para el vehículo.

Cada request aceptado a este endpoint consume 1 consulta de patente.

2. Consultá módulos adicionales#

Podés solicitar uno o varios módulos para la misma patente:

curl -X POST 'https://api.clasific.ar/v2/vehicles/ZZ000ZZ/modules' \
  -H 'x-api-key: <TU_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"modules":["fines","vtv","tax_debt"]}'

Cada módulo solicitado consume 1 consulta de módulo. En este ejemplo se consumen 3.

No necesitás consultar primero los datos básicos del vehículo.

La API devuelve una operación. Copiá el valor de id de la respuesta para consultar su estado en el siguiente paso.

3. Obtené el resultado#

Reemplazá <OPERATION_ID> por el id recibido y consultá la operación hasta que termine:

curl 'https://api.clasific.ar/v2/operations/<OPERATION_ID>' \
  -H 'x-api-key: <TU_API_KEY>'

Mientras la operación está en curso, su estado es queued o processing. Dejá de hacer polling cuando recibas completed, partial o failed.

Un módulo también puede indicar partial cuando obtuvo resultados pero alguna de sus fuentes no estuvo disponible.

El polling no consume consultas de patente ni de módulos. Cada request cuenta para el límite de requests por minuto de tu plan.

Repetir una consulta mientras está en curso#

Si volvés a solicitar para la misma patente exactamente el mismo conjunto de módulos mientras la operación sigue activa, Clasificar devuelve la operación existente en lugar de iniciar otra.

ZZ000ZZ + fines + vtv
ZZ000ZZ + vtv + fines

Estos dos pedidos se consideran la misma consulta mientras esté en curso. No se inicia nuevamente el trabajo y no se consume cupo adicional de módulos.

Cuando una operación ya terminó, una nueva solicitud vuelve a ejecutar los módulos y consume el cupo correspondiente.