Auto Parts Cross-Reference API

OEM & aftermarket cross-references (interchange) by part number — every analog carries a 0–100 confidence score and vote counts from independent data sources. Dirty part-number input is normalized server-side; prefix search and autocomplete included.

原始信息汇总

Auto Parts Cross-Reference API 数据集概述

该API提供汽车零部件OEM及售后市场的交叉引用（互换件）数据，核心特性如下：

• 数据内容：以零件编号为基础，查找其所有可互换的替代件（模拟件/交叉件）。
• 核心功能：
  • 置信度评分：每个替代件都有一个0-100的置信度分数（cf），反映独立数据源的共识程度。可通过min_confidence参数过滤。
  • 可验证数据：每个交叉件都附有赞成（vu）和反对（vd）的投票数，来源透明。
  • 模糊输入处理：自动标准化用户输入的零件号（如处理大小写、空格、破折号、斜杠），无需精确匹配。
  • 稳定标识符：每个零部件（pid）和品牌（bid）拥有稳定不变的公共ID，适合缓存和关联。
  • 前缀搜索与自动补全：支持通过前缀搜索零件号，并返回自动补全建议。
  • 多语言描述：零件描述支持36种语言（通过lang参数）。
  • OEM标识：每个零部件明确标记是否为OEM原厂件（oem: true）或售后市场件（oem: false）。
• API端点：
  • GET /v1/crosses：根据精确零件号查找其零件信息及带有置信度评分的交叉件列表（返回Top N，非全量）。
  • GET /v1/crosses/by-id：根据稳定的pid分页获取零件的所有交叉件（支持分页遍历全部数据）。
  • GET /v1/products：仅查找零件信息（无交叉件），支持精确或前缀搜索，并支持分页。
  • GET /v1/numbers：为零件号输入框提供自动补全建议。
  • GET /v1/brands：品牌目录，提供稳定的bid与规范品牌名对应。
  • GET /v1/version：查询当前数据快照的版本信息（也可通过HTTP响应头ETag获取）。
• 限制与说明：
  • /v1/crosses端点的limit参数是硬性上限（最大1000），只返回Top N的交叉件，无后续分页。
  • min_confidence仅过滤交叉件，不影响查询的目标零件返回。
  • 前缀搜索至少需要3个有效字符。
  • 数据版本通过ETag响应头传递，可用于缓存验证。
  • 错误响应结构为{"error": {"code": "...", "message": "..."}}。
• 适用场景：产品页面展示“替代品”区块、零件编号搜索框实现自动补全、消歧义同名零件、进行全量数据同步或目录构建。