Consulta vehicular por placa desde tu sistema.

Un endpoint para cada consulta vehicular

La consulta por placa, el SOAT y la revisión técnica tienen contratos diferentes. No supongas que una solicitud a /api/v1/vehiculo/placa también consulta la póliza o el historial de inspecciones. Cada resultado exitoso consume su propio crédito.

Valida la placa antes de enviarla y conserva su formato como texto. El contrato admite letras, números y guiones dentro del patrón publicado. Una entrada válida puede no producir resultados si la fuente no dispone de ese registro.

Cómo utilizar el resultado

La referencia enumera los campos que el backend conserva, incluidos los datos del vehículo que estén disponibles. Tu aplicación debe tolerar campos opcionales y no inventar datos cuando la fuente no responde.

Si utilizas la consulta en una plataforma de flotas, asocia el resultado al vehículo que la persona ha seleccionado y permite corregir la placa antes de guardar. Los datos consultados no sustituyen los documentos del vehículo ni certifican por sí solos quién conduce o quién está autorizado a utilizarlo.

Autenticación y límites

Usa Authorization: Bearer desde tu servidor y revisa success y el estado HTTP. Las respuestas de error llevan un código legible para tu aplicación. Si alcanzas un límite por minuto, espera antes de reintentar; si agotaste la cuota del periodo, revisa el plan en el dashboard.