rego检查器的API

您需要通过车牌和州验证澳大利亚车辆的rego，并且您需要在本周内完成。通过本文，您将确切知道如何调用返回注册信息的真实端点，包括制造商、型号、发动机和相关详细信息，以及如何将其连接到您的应用程序或AI代理。

此API提供的内容

澳大利亚rego检查器API根据注册号码和州返回核心车辆信息。典型字段包括描述、注册年份、制造商和型号（带嵌套结构）、带单位的发动机详细信息，以及与记录相关的州。它用于经销商入驻、保险报价、车队操作、市场列表、结账验证，以及任何必须在继续之前确认详细信息的工作流程。

该端点支持澳大利亚州代码： NSW, VIC, TAS, WA, SA, QLD, ACT, NT。

它可在 Zyla API Hub 上获得，这是一个拥有超过10,000个公共API的市场，您只需一个账户、一个API密钥和一个订阅模型。您将获得订阅 + 配额（不是按调用计费）。对于这个第一个API，有7天的试用期或50个请求供您使用——请查看API页面以获取当前的访问选项和定价。

在Zyla API Hub上开始

尝试一下：

• 打开列表： 开始7天的澳大利亚rego检查器API试用。
• 点击订阅或开始免费试用（可用时）并获取您的API密钥。
• 在Authorization头中使用API密钥，如：Authorization: Bearer YOUR_API_KEY。

如果您是Zyla的新用户，您还可以在 zylalabs.com 上浏览目录并创建您的账户，以便在市场上获取密钥。

端点概述

只需一个端点即可查找rego：

• 端点：rego检查器
• 方法：GET
• URL：https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker
• 所需查询参数：
  • registrationNumber（字符串）：示例322IK8
  • state（字符串）：NSW、VIC、TAS、WA、SA、QLD、ACT、NT之一
• 身份验证：Authorization: Bearer YOUR_API_KEY

您可以粘贴的快速请求

复制、粘贴并运行。用您的列表中的密钥替换YOUR_API_KEY。

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"

官方示例响应

{
"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"
}

在您的应用程序中使用：

• Description、RegistrationYear用于简洁的摘要和UI标签。
• CarMake.CurrentTextValue和ModelDescription.CurrentTextValue用于标准化的制造商/型号。
• extended.engine.capacity.value和extended.engine.capacity.unit用于数值容量（在此示例中以L为单位的值）。
• Engine用于人类可读的字符串；如果您更喜欢结构化详细信息，请使用extended.engine.description。
• State反映与结果相关的州。

Python示例：提取您需要的内容

此示例调用相同的端点，检查HTTP状态，并标准化制造商/型号和发动机容量以供后续使用。它使用与上面的curl相同的注册号码和州，以便您可以逐一比较结果。

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

# 提取核心字段
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)

节省时间的实施注意事项

• 州代码是严格的。使用以下之一：NSW、VIC、TAS、WA、SA、QLD、ACT、NT。进行客户端验证以防止可避免的4xx响应。
• 单位：扩展有效负载中的发动机容量包括数值和单位（在示例中为L）。保留两者以供显示和后续计算。
• 可能存在空字段（例如，示例中的Colour或Expiry）。使用.get()和合理的默认值进行防御性编码。
• 缓存：如果您的工作流程在短时间内多次检查相同的rego，请通过registrationNumber + state进行缓存，以减少延迟和调用。当用户编辑输入时使其失效。
• 超时和重试：设置客户端超时。仅在您的用户体验可以容忍的情况下对安全的幂等GET进行重试。
• 日志记录：记录状态/车牌对和HTTP状态以便观察。除非必要支持，否则在生产中避免记录完整有效负载。

常见用例

• 结账验证：确认买方输入的rego与已知的制造商/型号匹配，然后允许添加保险附加项。
• 经销商或车队入驻：根据车牌自动填充车辆规格，以减少手动输入和错误。
• 市场列表：预填充型号、系列、传动类型和发动机详细信息，以标准化列表。
• 风险和合规性：交叉检查标准化字段，如extended.nvic和code，以符合内部规则或匹配。

通过MCP从AI代理调用

如果您使用MCP兼容工具（Claude Code、Cursor、Windsurf等），您可以通过Zyla MCP端点路由调用。将您的代理或工具配置指向MCP URL，并按照文档传递您的API密钥。请参见此处的参考： MCP。

当您的代理调用澳大利亚rego检查器API时，请确保它向rego-checker URL发出GET请求，并带有registrationNumber和state参数，并包括Authorization: Bearer YOUR_API_KEY。保持州代码在允许的集合中，以避免对无效输入的重试。

生产检查清单

• 输入验证：在客户端标准化和大写州代码；修剪车牌输入。
• 可观察性：捕获请求ID和车牌/州对以进行调试；如果存在，删除用户PII。
• 错误表面：显示可操作消息以区分4xx（无效车牌或州）与5xx（临时问题，请重试）。
• 回退策略：仅对瞬态故障进行指数回退；在客户端错误上不要重试。
• 数据映射：将嵌套字段（例如，extended.engine.capacity）映射到您的领域模型中，以避免后续的临时字符串解析。

参考：您需要的一个端点

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

• 查询参数：
  • registrationNumber：字符串，必需（示例：322IK8）
  • state：字符串，必需（NSW、VIC、TAS、WA、SA、QLD、ACT、NT之一）
• 头部：
  • Authorization：Bearer YOUR_API_KEY

计费和访问

• 模型：订阅 + 配额（不是按调用计费）。
• 首次API访问：7天试用或50个请求。可用性可能会变化；请查看列表以获取当前选项。
• 没有免费计划。使用试用来验证集成和规模。

常见问题解答

支持哪些州？
NSW、VIC、TAS、WA、SA、QLD、ACT、NT。使用这些确切代码之一作为州参数。

需要哪些参数？
registrationNumber和state是必需的。在GET请求中将它们作为查询参数传递。

我如何进行身份验证？
在请求头中包含Authorization: Bearer YOUR_API_KEY。您的密钥在订阅列表后可用。

每个字段都会存在吗？
某些字段可能为空，具体取决于记录（例如，示例中的Colour或Expiry）。检查null/空值。

我可以从AI代理调用这个吗？
可以。MCP兼容的代理可以通过Zyla MCP入口点调用相同的端点；请参见MCP参考并包含您的Authorization头。

准备在几分钟内实现rego查找吗？在列表中订阅并获取您的密钥： 开始7天的澳大利亚rego检查器API试用。然后通过单个GET调用交付您的集成。