按品牌车型目录 — 现在通过 VIN
Vindec 是一个 API,它将 VIN 转换为 FAPI 按品牌车型目录 中的车辆 ID。目录直接定位到正确的车型版本,无需在店面手动执行「品牌 → 车型 → 版本」步骤。
内含
- 17 位 VIN 作为输入,JSON 作为输出。
- 响应包含制造商、车型版本(发动机 + 年份 + 车身)、功率(kW)、排量(cm³)、燃料类型、车身类型、驱动方式、变速箱,以及用于直接进入目录的车型和具体版本 ID。
- 每个响应中都有 可信度级别:
exact/partial/brand_only/unknown。如果不确定,我们会明确指出。 - 目录参考数据本地存储 — 车型和车辆类型保存在我们这边,无需每次请求都通过网络查询。
响应示例
请求:GET /v1/decode?vin=WVWZZZ1JZXW000010
{
"confidence": "exact",
"vin": "WVWZZZ1JZXW000010",
"manufacturer": "Volkswagen",
"model": "Golf IV",
"modification": "1.6 (AKL, AEH)",
"year_from": 1997,
"year_to": 2006,
"body_type": "Hatchback",
"engine_kw": 74,
"engine_cc": 1595,
"fuel": "petrol",
"drive": "FWD",
"gearbox": "MT",
"catalog": {
"model_id": "20210",
"type_id": "1041"
}
}
WMI/VDS/VIS 的 ISO 3779 拆解发生在 Vindec 内部;调用方拿到的是已就绪的车型版本以及一对 ID,可直接进入 FAPI 按品牌车型目录。当 VIN 仅部分解码时(例如 WMI 明确,但车型版本不明确),confidence 返回 brand_only 或 partial — 这是给 UI 的信号:显示手动车型版本选择,不要猜测。
适用对象
服务面向 FAPI 按品牌车型目录 的客户。
- 已经购买目录 — Vindec 作为另一个入口集成到您的店面或 1C 前端:客户不再手动选择品牌/车型,而是输入 VIN。
- 正在考虑购买目录 — Vindec 与目录配套使用,因此从目录本身开始是合理的。
- 没有 FAPI 按品牌车型目录 — 暂时没有意义:Vindec 返回的是目录 ID,需要有地方去查询它。
嵌入场景
三种典型场景 — 每种都有自己的 UI,共同点是相同的:客户或专员不再手动输入「品牌 → 车型 → 版本」,而是传入 VIN,目录直接打开到正确的条目。
零配件门店店面。 在常规品牌选择器旁边放一个「VIN」字段。客户从行驶证或挡风玻璃上复制 17 个字符 — 目录直接跳到正确的发动机和年代。当解码是部分的(partial / brand_only)时,店面显示已匹配的部分,并为其余情况保留手动路径。在已覆盖的车型上 — 零「车型版本错误」错误。
柜台专员软件(基于 1C)。 配件销售员接到电话:「Skoda Octavia 2011,需要刹车片。」追问:「能给我念一下 VIN 吗?」— 一秒钟后,屏幕已经在正确的车型版本上,无需手动选择 A5 vs A7、改款前 vs 改款后、1.6 MPI vs 1.4 TSI。场景速度提升 3-5 倍;错误零件错误在输入阶段就被过滤。
汽修店移动接车。 接车员用手机扫描发动机舱里的 VIN 条形码,得到车型版本,立刻在 FAPI 按品牌车型目录中看到保养项目(机油、滤芯、皮带)。在车厢内离线工作:目录参考数据本地存储,只有 Vindec 调用走网络。
为什么用 API,而不是手动选择器
- 速度。 配件销售员花费几秒钟而非几分钟在品牌 → 车型 → 版本 → 发动机之间导航。在通话排队的情况下,这每月节省数十小时。
- 车型版本精度。 VIN 唯一编码发动机、生产年份和配置。手动选择依赖客户的记忆(「我的是 2014 年… 我想是 1.6…」)— 这是错误零件和退货之路。
- 入门门槛。 没有在特定品牌上多年经验的较新销售员也能做出正确的选择:VIN 解码器处理了一位资深专员脑子里所掌握的内容。
- 审计可追溯性。 订单保留原始 VIN — 有争议的退货以事实解决,而不是「他告诉我,我选的」。
状态:封闭测试
自 2026-05-16 起,为现有目录客户开放早期访问。测试意味着:
- 容量有限;访问按批次发放。
- Pilot 定价与参与者单独协商,并在合同期内固定。
- 早期用户的反馈直接进入 roadmap。
加入 waitlist
- 邮箱:
fapi@iisis.ru,主题Vindec beta。正文中说明公司、是否已有目录、计划的 VIN 查询量。 - Telegram 更新频道: @database_auto_parts — 新访问批次的通知。
技术细节
- REST API,JSON。
- Go 服务,PostgreSQL 存储,加上 FAPI 按品牌车型目录的只读参考数据(MariaDB)。
- 部署:由我们托管或在您侧 self-hosted(与测试参与者讨论)。
- 文档和 Swagger 在访问开通后提供。
常见问题
支持哪些品牌?
API 支持我们 FAPI 按品牌车型目录中所有有数据的品牌和车型。
测试期间的速率限制如何?
单独协商。如果您的用例是将 Vindec 集成到每天数千个请求的店面,请在注册时说明,以便我们正确规划容量。
这是目录的替代品吗?
不是。Vindec 不出货零件,也不构建品牌/车型层次结构。它返回一个车辆 ID — 进入您已经拥有的 FAPI 按品牌车型目录的入口点。
何时正式发布?
测试结束后。我们不公布日期,以免在「承诺」和与早期客户的工作之间分散注意力。
如果 VIN 无法完全解码怎么办?
Vindec 返回 confidence: partial 或 brand_only,并填入它能够确定的字段(例如,仅从 WMI 得到制造商)。这是给您的 UI 的明确信号:显示手动车型版本选择器,不要盲目替换零件编号。Vindec 不返回猜测 — 我们不编造未被编码的内容。
没有 VIN 的 JDM 车和早期苏联 VAZ 怎么办?
车身号码格式为 XXX-1234567 的 JDM 车以及早期苏联/早期 VAZ 编号不在 ISO 3779 的描述范围内 — Vindec 对它们返回 confidence: unknown,流程必须回退到手动输入。在 RU 市场,这是一个不小的份额;重要的是 UI 在这些情况下不要崩溃,而是优雅地降级到旧路径。
响应延迟是多少?
解码花费数十毫秒,加上对 MariaDB 参考数据的一次本地查询。热路径中没有外部 API — 一切都是本地只读。这使得 Vindec 可以安全地直接嵌入到 Web 表单的 input-onChange 中,而不会让用户感知到延迟。
VIN 的隐私如何处理?
VIN 本身不是个人数据 — 它标识的是车辆,而不是车主。但我们不存储您请求中的原始 VIN:仅存储聚合的使用统计(请求数、可信度分布、常见的 WMI)。如果您有合规任务,这会单独写入合同。
支持 self-hosted 吗?
与测试参与者协商。架构上,Vindec 是单个 Go 二进制文件 + PostgreSQL + FAPI 按品牌车型目录参考数据的只读副本;在 Docker 中一小时内即可部署。如果您有本地部署需求(银行、公共部门),这是一个受支持的路径。