API para verificador de rego

Você precisa verificar o rego de um veículo australiano pela placa e estado, e precisa que isso funcione esta semana. Ao final deste artigo, você saberá exatamente como chamar um endpoint real que retorna marca, modelo, motor e detalhes relacionados para um registro, além de como integrá-lo ao seu aplicativo ou a um agente de IA.

O que esta API entrega

A API do Verificador de Rego da Austrália retorna informações principais do veículo a partir de um número de registro e estado. Os campos típicos incluem descrição, ano de registro, marca e modelo (com estruturas aninhadas), detalhes do motor com unidades e o estado associado ao registro. É usada na integração de concessionárias, cotações de seguros, operações de frotas, listagens de mercado, verificação de checkout e qualquer fluxo de trabalho onde você deve confirmar detalhes antes de prosseguir.

Ilustração: API para verificador de rego

O endpoint suporta códigos de estado australianos: NSW, VIC, TAS, WA, SA, QLD, ACT, NT.

Está disponível no Zyla API Hub, um marketplace com mais de 10.000 APIs públicas sob uma conta, uma chave de API e um modelo de assinatura. Você obtém assinatura + cota (não é pago por chamada). Para esta primeira API, há um teste de 7 dias ou 50 solicitações para você começar—verifique a página da API para opções de acesso e preços atuais.

Começando no Zyla API Hub

Para experimentá-la:

Abra a listagem: Inicie o teste de 7 dias na API do Verificador de Rego da Austrália.
Clique em Assinar ou Iniciar Teste Gratuito (quando disponível) e obtenha sua chave de API.
Use a chave de API no cabeçalho de Autorização como: Authorization: Bearer YOUR_API_KEY.

Se você é novo no Zyla, também pode navegar pelo catálogo em zylalabs.com e criar sua conta para obter uma chave em todo o marketplace.

Visão geral do endpoint

Apenas um endpoint é necessário para procurar um 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 obrigatórios:
- registrationNumber (string): Exemplo 322IK8
- state (string): Um dos NSW, VIC, TAS, WA, SA, QLD, ACT, NT
Autenticação: Authorization: Bearer YOUR_API_KEY

Solicitação rápida que você pode colar

Copie, cole e execute. Substitua YOUR_API_KEY pela sua chave da listagem.

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"

Resposta de exemplo 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"
}

O que usar em seu aplicativo:

Description, RegistrationYear para resumos concisos e rótulos de UI.
CarMake.CurrentTextValue e ModelDescription.CurrentTextValue para marca/modelo normalizados.
extended.engine.capacity.value e extended.engine.capacity.unit para capacidade numérica (valor em L neste exemplo).
Engine para uma string legível por humanos; extended.engine.description se você preferir detalhes estruturados.
State reflete o estado associado ao resultado.

Exemplo em Python: extraia o que você precisa

Este exemplo chama o mesmo endpoint, verifica o status HTTP e normaliza a marca/modelo e a capacidade do motor para uso posterior. Ele usa o mesmo número de registro e estado que o curl acima para que você possa comparar resultados um a um.

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()

# Extrair campos principais
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 implementação que economizam tempo

Códigos de estado são rigorosos. Use um dos: NSW, VIC, TAS, WA, SA, QLD, ACT, NT. Valide do lado do cliente para evitar respostas 4xx evitáveis.
Unidades: a capacidade do motor na carga estendida inclui um valor numérico e unidade (L no exemplo). Mantenha ambos para exibição e cálculos posteriores.
Campos vazios são possíveis (por exemplo, Cor ou Expiração no exemplo). Codifique defensivamente com .get() e padrões sensatos.
Cache: se seu fluxo de trabalho verifica o mesmo rego várias vezes em uma janela curta, faça cache por registrationNumber + state para reduzir latência e chamadas. Invalide quando o usuário editar a entrada.
Timeouts e tentativas: defina um timeout do lado do cliente. Tente novamente apenas em GETs seguros e idempotentes quando sua UX puder tolerar.
Registro: registre o par estado/placa e o status HTTP para observabilidade. Evite registrar cargas completas em produção, a menos que necessário para suporte.

Casos de uso comuns

Verificação de checkout: confirme se o rego inserido pelo comprador corresponde a uma marca/modelo conhecido antes de permitir complementos de seguro.
Entrada de concessionária ou frota: preencha automaticamente as especificações do veículo a partir de uma placa para reduzir a entrada manual e erros.
Listagens de mercado: preencha automaticamente modelo, série, tipo de transmissão e detalhes do motor para padronizar listagens.
Risco e conformidade: verifique campos de normalização como extended.nvic e código para regras internas ou correspondência.

Chamando de agentes de IA via MCP

Se você usar ferramentas compatíveis com MCP (Claude Code, Cursor, Windsurf e outras), pode direcionar chamadas através do endpoint MCP da Zyla. Aponte a configuração do seu agente ou ferramenta para a URL do MCP e passe sua chave de API conforme documentado. Veja a referência aqui: MCP.

Quando seu agente invocar a API do Verificador de Rego da Austrália, certifique-se de que ele emita um GET para a URL do rego-checker com os parâmetros registrationNumber e state, e inclua Authorization: Bearer YOUR_API_KEY. Mantenha os códigos de estado no conjunto permitido para evitar tentativas em entradas inválidas.

Lista de verificação de produção

Validação de entrada: normalize e coloque em maiúsculas os códigos de estado do lado do cliente; corte a entrada da placa.
Observabilidade: capture IDs de solicitação e pares de placa/estado para depuração; redija PII do usuário, se presente.
Superfícies de erro: mostre mensagens acionáveis para 4xx (placa ou estado inválido) vs 5xx (problema temporário, tente novamente).
Política de retrocesso: retrocesso exponencial em falhas transitórias apenas; não tente novamente em erros do cliente.
Mapeamento de dados: mapeie campos aninhados (por exemplo, extended.engine.capacity) em seu modelo de domínio para evitar análise de string ad hoc mais tarde.

Referência: o único endpoint que você precisa

GET https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker

Parâmetros de consulta:
- registrationNumber: string, obrigatório (exemplo: 322IK8)
- state: string, obrigatório (um dos NSW, VIC, TAS, WA, SA, QLD, ACT, NT)
Cabeçalhos:
- Authorization: Bearer YOUR_API_KEY

Cobrança e acesso

Modelo: assinatura + cota (não pago por chamada).
Primeiro acesso à API: teste de 7 dias ou 50 solicitações. A disponibilidade pode mudar; verifique a listagem para opções atuais.
Sem plano gratuito. Use o teste para validar a integração e o dimensionamento.

FAQ

Quais estados são suportados?
NSW, VIC, TAS, WA, SA, QLD, ACT, NT. Use um desses códigos exatos para o parâmetro de estado.

Quais parâmetros são obrigatórios?
registrationNumber e state são obrigatórios. Passe-os como parâmetros de consulta na solicitação GET.

Como eu me autentico?
Inclua Authorization: Bearer YOUR_API_KEY nos cabeçalhos da solicitação. Sua chave está disponível após a assinatura na listagem.

Todos os campos estarão presentes?
Alguns campos podem estar vazios dependendo do registro (por exemplo, Cor ou Expiração no exemplo). Verifique valores nulos/vazios.

Posso chamar isso de um agente de IA?
Sim. Agentes compatíveis com MCP podem chamar o mesmo endpoint através do ponto de entrada MCP da Zyla; veja a referência MCP e inclua seu cabeçalho de Autorização.

Pronto para implementar uma busca de rego em minutos? Assine e obtenha sua chave na listagem: Inicie o teste de 7 dias na API do Verificador de Rego da Austrália. Depois, envie sua integração com uma única chamada GET.