Skip to main content
POST
Crear consulta

Autenticación

Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de Autenticación):

Atributos Requeridos

vin
string
required
Número de identificación del vehículo (VIN). 17 caracteres alfanuméricos, sin las letras I, O ni Q (ISO 3779).
El formato del VIN se valida de forma síncrona: si no cumple, la API responde 422 de inmediato y la consulta no se encola. Si es válido, responde 202 con un task_id que usarás para hacer polling del resultado en Consultar respuesta.

Respuesta

status
string
Resultado de negocio: success o error. En este endpoint una validación fallida devuelve success con el detalle en errors.
message
string
Mensaje legible del resultado.
data
object | null
Carga útil de la respuesta.
errors
object
Solo presente en validación (422): mapa campo → [mensajes], formato Laravel.

Ejemplo de Solicitud

Ejemplo de Respuesta Exitosa

Respuesta 202 (aceptada): el VIN es válido y la consulta quedó en proceso.

Ejemplo de Respuesta de Validación

Respuesta 422: el VIN no cumple el formato. La consulta no se encola.

Códigos de Error

CódigoDescripción
401Token de autenticación inválido o faltante
422Validación del VIN: el campo vin es requerido o no cumple el formato (17 alfanuméricos, sin I/O/Q). Detalle en errors