Necesitas verificar el rego de un vehículo australiano por placa y estado, y necesitas que funcione esta semana. Al final de este artículo, sabrás exactamente cómo llamar a un endpoint real que devuelve la marca, modelo, motor y detalles relacionados para un registro, además de cómo integrarlo en tu aplicación o en un agente de IA.
Lo que esta API ofrece
La API de Verificador de Rego de Australia devuelve información básica del vehículo a partir de un número de registro y estado. Los campos típicos incluyen descripción, año de registro, marca y modelo (con estructuras anidadas), detalles del motor con unidades, y el estado asociado con el registro. Se utiliza en la incorporación de concesionarios, cotizaciones de seguros, operaciones de flota, listados en mercados, verificación de pago, y cualquier flujo de trabajo donde debas confirmar detalles antes de proceder.
El endpoint soporta códigos de estado australianos: NSW, VIC, TAS, WA, SA, QLD, ACT, NT.
Está disponible en Zyla API Hub, un mercado con más de 10,000 APIs públicas bajo una cuenta, una clave API y un modelo de suscripción. Obtienes suscripción + cuota (no pago por llamada). Para esta primera API, hay una prueba de 7 días o 50 solicitudes para que puedas comenzar; consulta la página de la API para las opciones de acceso y precios actuales.
Comenzando en Zyla API Hub
Para probarlo:
- Abre el listado: Iniciar prueba de 7 días en la API de Verificador de Rego de Australia.
- Haz clic en Suscribirse o Iniciar Prueba Gratuita (cuando esté disponible) y obtén tu clave API.
- Usa la clave API en el encabezado de Autorización como: Authorization: Bearer YOUR_API_KEY.
Si eres nuevo en Zyla, también puedes navegar por el catálogo en zylalabs.com y crear tu cuenta para obtener una clave en todo el mercado.
Descripción general del endpoint
Solo se necesita un endpoint para buscar un rego:
- Endpoint: Verificador de Rego
- Método: GET
- URL: https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker
- Parámetros de consulta requeridos:
- registrationNumber (cadena): Ejemplo 322IK8
- state (cadena): Uno de NSW, VIC, TAS, WA, SA, QLD, ACT, NT
- Autenticación: Authorization: Bearer YOUR_API_KEY
Solicitud rápida que puedes pegar
Copia, pega y ejecuta. Reemplaza YOUR_API_KEY con tu clave del listado.
curl -s -X GET "https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker?registrationNumber=322IK8&state=QLD" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta oficial
{
"Description": "BMW M3 4D Sedan ",
"RegistrationYear": "2011",
"CarMake": {
"CurrentTextValue": "BMW"
},
"MakeDescription": {
"CurrentTextValue": "BMW"
},
"ModelDescription": {
"CurrentTextValue": "M3 4D Sedan"
},
"BodyStyle": {
"CurrentTextValue": "7-Speed Auto Direct Shift"
},
"Colour": "",
"VechileIdentificationNumber": "BMW-M3--E040IY92011A",
"Engine": "4.0 litre, V8, E90",
"extended": {
"nvic": "IY911A",
"code": "BMW-M3--E040IY92011A",
"year": "2011",
"make": "BMW",
"model": "M3 4D Sedan",
"bodyType": "7-Speed Auto Direct Shift",
"engine": {
"capacity": {
"value": "4.0",
"unit": "L"
},
"cylinders": "V8",
"description": "4.0 litre, V8, E90"
},
"transmissionType": "Auto",
"driveType": "4D SEDAN",
"family": "M3",
"variant": "",
"series": "E90"
},
"Expiry": "",
"State": "NSW"
}Lo que debes usar en tu aplicación:
- Description, RegistrationYear para resúmenes concisos y etiquetas de UI.
- CarMake.CurrentTextValue y ModelDescription.CurrentTextValue para marca/modelo normalizados.
- extended.engine.capacity.value y extended.engine.capacity.unit para capacidad numérica (valor en L en este ejemplo).
- Engine para una cadena legible por humanos; extended.engine.description si prefieres detalles estructurados.
- State refleja el estado asociado con el resultado.
Ejemplo en Python: extrae lo que necesitas
Este ejemplo llama al mismo endpoint, verifica el estado HTTP y normaliza la marca/modelo y la capacidad del motor para su uso posterior. Utiliza el mismo número de registro y estado que el curl anterior para que puedas comparar resultados uno a uno.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker"
params = {
"registrationNumber": "322IK8",
"state": "QLD"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# Extraer campos básicos
description = data.get("Description", "").strip()
reg_year = data.get("RegistrationYear")
make = (data.get("CarMake") or {}).get("CurrentTextValue")
model = (data.get("ModelDescription") or {}).get("CurrentTextValue")
engine_text = data.get("Engine")
extended = data.get("extended") or {}
engine_ext = extended.get("engine") or {}
capacity = (engine_ext.get("capacity") or {}).get("value")
capacity_unit = (engine_ext.get("capacity") or {}).get("unit")
cylinders = engine_ext.get("cylinders")
series = extended.get("series")
summary = {
"description": description,
"registration_year": reg_year,
"make": make,
"model": model,
"engine_text": engine_text,
"engine_capacity_value": capacity,
"engine_capacity_unit": capacity_unit,
"cylinders": cylinders,
"series": series,
"state": data.get("State")
}
print(summary)Notas de implementación que ahorran tiempo
- Los códigos de estado son estrictos. Usa uno de: NSW, VIC, TAS, WA, SA, QLD, ACT, NT. Valida del lado del cliente para evitar respuestas 4xx evitables.
- Unidades: la capacidad del motor en la carga extendida incluye un valor numérico y una unidad (L en el ejemplo). Mantén ambos para mostrar y cálculos posteriores.
- Los campos vacíos son posibles (por ejemplo, Color o Expiración en la muestra). Programa defensivamente con .get() y valores predeterminados sensatos.
- Cacheo: si tu flujo de trabajo verifica el mismo rego múltiples veces en una ventana corta, almacena en caché por registrationNumber + state para reducir la latencia y las llamadas. Invalida cuando el usuario edita la entrada.
- Timeouts y reintentos: establece un timeout del lado del cliente. Reintenta solo en GETs seguros e idempotentes cuando tu UX pueda tolerarlo.
- Registro: registra el par estado/placa y el estado HTTP para la observabilidad. Evita registrar cargas completas en producción a menos que sea necesario para soporte.
Casos de uso comunes
- Verificación de pago: confirma que el rego ingresado por el comprador coincide con una marca/modelo conocido antes de permitir complementos de seguro.
- Incorporación de concesionarios o flotas: completa automáticamente las especificaciones del vehículo a partir de una placa para reducir la entrada manual y errores.
- Listados en mercados: pre-puebla modelo, serie, tipo de transmisión y detalles del motor para estandarizar listados.
- Riesgo y cumplimiento: verifica campos de normalización como extended.nvic y código para reglas internas o coincidencias.
Llamando desde agentes de IA a través de MCP
Si usas herramientas compatibles con MCP (Claude Code, Cursor, Windsurf y otras), puedes enrutar llamadas a través del endpoint MCP de Zyla. Apunta la configuración de tu agente o herramienta a la URL de MCP y pasa tu clave API como se documenta. Consulta la referencia aquí: MCP.
Cuando tu agente invoque la API de Verificador de Rego de Australia, asegúrate de que emita un GET a la URL de rego-checker con los parámetros registrationNumber y state, e incluya Authorization: Bearer YOUR_API_KEY. Mantén los códigos de estado en el conjunto permitido para evitar reintentos en entradas inválidas.
Lista de verificación de producción
- Validación de entrada: normaliza y convierte a mayúsculas los códigos de estado del lado del cliente; recorta la entrada de la placa.
- Observabilidad: captura IDs de solicitud y pares de placa/estado para depuración; redacta PII del usuario si está presente.
- Superficies de error: muestra mensajes accionables para 4xx (placa o estado inválido) vs 5xx (problema temporal, intenta de nuevo).
- Política de retroceso: retroceso exponencial solo en fallos transitorios; no reintentes en errores del cliente.
- Mapeo de datos: mapea campos anidados (por ejemplo, extended.engine.capacity) en tu modelo de dominio para evitar análisis de cadenas ad hoc más tarde.
Referencia: el único endpoint que necesitas
GET https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker
- Parámetros de consulta:
- registrationNumber: cadena, requerido (ejemplo: 322IK8)
- state: cadena, requerido (uno de NSW, VIC, TAS, WA, SA, QLD, ACT, NT)
- Encabezados:
- Authorization: Bearer YOUR_API_KEY
Facturación y acceso
- Modelo: suscripción + cuota (no pago por llamada).
- Primer acceso a la API: prueba de 7 días o 50 solicitudes. La disponibilidad puede cambiar; consulta el listado para las opciones actuales.
- No hay plan gratuito. Usa la prueba para validar la integración y el tamaño.
FAQ
¿Qué estados están soportados?
NSW, VIC, TAS, WA, SA, QLD, ACT, NT. Usa uno de estos códigos exactos para el parámetro de estado.
¿Qué parámetros son requeridos?
registrationNumber y state son requeridos. Pásalos como parámetros de consulta en la solicitud GET.
¿Cómo me autentico?
Incluye Authorization: Bearer YOUR_API_KEY en los encabezados de la solicitud. Tu clave está disponible después de suscribirte en el listado.
¿Estará presente cada campo?
Algunos campos pueden estar vacíos dependiendo del registro (por ejemplo, Color o Expiración en la muestra). Verifica valores nulos/vacíos.
¿Puedo llamar a esto desde un agente de IA?
Sí. Los agentes compatibles con MCP pueden llamar al mismo endpoint a través del punto de entrada MCP de Zyla; consulta la referencia MCP e incluye tu encabezado de Autorización.
¿Listo para implementar una búsqueda de rego en minutos? Suscríbete y obtén tu clave en el listado: Iniciar prueba de 7 días en la API de Verificador de Rego de Australia. Luego envía tu integración con una sola llamada GET.
