汽车配件 API 应按已有输入和目标结果选择：识别车辆用 VIN，维护车型层级用车型库，目录查件用 EPC，从编号识别零件与替换关系用 OE，按车型找候选用车型零件搜索。
五类 API 分别解决什么问题？
极速车服的 VIN、车型、EPC、配件 OE 和车型零件搜索是不同产品路径。它们可以组成一条业务链，但输入、输出和失败处理并不相同。开发时应把每类接口路由到明确任务，避免用一个“万能搜索框”承接所有请求。
| 查询任务 | 主要已有信息 | 目标结果 | 对应官方入口 |
|---|---|---|---|
| 识别车辆 | VIN | 一个或多个车型候选及车辆字段 | VIN 查询 API |
| 同步车型主数据 | 品牌、车系、年款或关键词 | 品牌到具体车款的层级与车型 ID | 车型大全 API |
| 在已确认车辆目录中查件 | carid 或 VIN、EPC 分组 | 末级分组及零件列表 | EPC 全车件 API |
| 从已知编号识别零件 | OE 号或零件 ID | 零件身份、销售车型、替换关系 | 配件 OE 信息 API |
| 在指定车型内模糊找件 | carid 或 VIN，加名称或编号 | 车辆范围内的零件候选 | 车型零件搜索 API |
这是一套基于当前产品输入与输出形成的任务分流框架，不是对所有汽配系统都适用的唯一架构。具体权限、计费和支持范围仍应以查询当天的官方页面和账号联调为准。
只有 VIN 时应该从哪里开始？
只有 VIN 时先调用车辆识别接口。VIN 查询页面把可能的车型放在 carlist 中，因此系统应保留全部候选并完成车型确认，不能默认选择第一条。
车型确认后再看业务目标：需要浏览原厂配件目录，进入 EPC；需要按零件名称快速找候选，进入车型零件搜索；需要查询保养、出厂环保或原厂配置等其他信息，则应选择对应的专用产品，而不是从普通 VIN 字段自行推导。
已有车型数据时还需要 VIN 吗？
如果系统正在建设品牌、车系、年款和具体车款的主数据，车型大全 API 更适合做层级同步。其价值是建立车型 ID 与内部主数据的映射，而不是替代每一辆实车的身份确认；ID 的长期稳定性仍应通过版本记录和实际联调验证。
业务工单已经有明确 carid 时，可以直接进入依赖车型 ID 的后续查询；如果存在改款、配置或实车信息冲突，仍需回到 VIN、行驶证、铭牌或人工确认。车型层级和车辆实例应在数据模型中分开保存。
查原厂目录为什么要用 EPC？
EPC 全车件接口不是一次返回全部配件。当前文档将流程拆为 epc2/class 和 epc2/parts：先获取目录分组，依据 isend 找到末级节点，再把末级 classid 用于零件查询。
因此，适合 EPC 的问题是“这辆已确认的车，在某个目录部位有哪些零件”。如果用户只有一个 OE 号，先做全局编号查询通常更直接；如果用户只知道“前保险杠支架”之类名称，可以在车型范围内搜索候选，或进入 EPC 对应部位查找。
OE 查询和车型零件搜索怎么选？
选择依据是查询起点：
- 从编号出发：使用配件 OE 信息查询，先识别零件，再查销售车型或替换件；
- 从车辆出发：使用车型零件搜索，在指定车型内按名称或编号缩小候选；
- 从目录部位出发：使用 EPC，沿分组进入末级分类；
- 编号和车辆都不确定：先补充 VIN、旧件照片、安装位置或包装信息，不要直接生成采购结论。
车型零件搜索页面公开了 name、number 等输入，并以 isvinparts 标记数据来源；该标记可以作为候选来源保存，但不能单独证明绝对适配。
后端怎样设计接口路由？
可以先把用户请求归入四类动作：车辆识别、车型同步、目录定位、编号核验。每次调用都保存原始输入、所选产品、返回状态、候选集合、确认人和查询时间。
建议的最小路由如下：
- VIN 输入进入车辆识别，结果未确认时停止后续查件；
- 车型主数据更新进入车型大全，同步外部 ID 与层级；
- 已确认车型加目录需求进入 EPC，保存完整分组路径；
- 已知 OE 号进入零件号搜索，再按需要查询销售车型和替换关系；
- 已确认车型加零件名称进入车型零件搜索，生成待复核候选；
- 所有结果在报价、采购或安装前进入适配复核状态。
错误也应按产品隔离。VIN 无信息、EPC 分组错误、车型 ID 错误和零件名称过短属于不同处理动作，不能统一显示为“没有配件”。
选型时还要确认哪些动态条件？
正式接入前，应在对应产品页确认当前请求方式、参数口径、字段、错误码、账户权限、计费与支持范围。示例请求使用 YOUR_APPKEY、YOUR_VIN 等占位符，真实 APPKEY 只保存在服务端；未完成真实联调时，不应声称接口已经测试通过。
接口结果也不等于采购保证。车型、目录、OE、替换关系和价格都需要结合车辆配置、生产批次、左右侧、实物与供应信息继续核对。
总结
汽车配件 API 的选择顺序是“先确定已有输入，再确定要得到什么结果”。VIN 负责车辆识别，车型大全负责主数据，EPC 负责目录定位，OE 查询负责编号身份与替换关系，车型零件搜索负责在车辆范围内发现候选。按任务路由并保留失败出口，比把所有能力堆进一个接口更容易维护和解释。
