已确认具体车型后，可用零件名称做发现式搜索，也可用零件号缩小范围；只有 VIN 时则先确认能否锁定车型。名称至少满足文档长度要求，名称和零件号不应同时为空，返回结果仍需结合车型、编号和实物复核。

车型零件搜索与 OE 查询有什么不同

极速车服车型零件搜索 API的官方说明是：通过车型 ID 或 VIN，使用零件名称或者零件号模糊查询一个车型的零件信息。接口地址为 https://api.jisuepc.com/parts2/query，支持 GET、POST。

它的核心前提是“先限定车辆，再搜索零件”。而配件 OE 信息查询更适合从已知编号出发识别零件、销售车型或替换关系。两者可以形成前后衔接，但不能把“车型内模糊搜索”写成“任意零件号的全局身份查询”。

适合使用车型零件搜索的场景包括：维修接待只知道“中网”“前保险杠”等名称；车型已经确认，但旧件编号不完整；配件客服希望在指定车辆范围内生成候选清单。

carid 和 VIN 应该怎么传

官方参数表把 carid 标为必填，同时在 VIN 说明中写明“carid 和 vin 至少选一个”。页面总说明也写着可以通过车型 ID/VIN 查询。这几处口径并不完全一致，所以只有 VIN 的请求不能仅凭文字说明直接承诺可用。

更稳妥的接入顺序是：

  1. 已有车型大全中的具体车款 ID，按文档示例传 carid；
  2. 只有 VIN 时，在测试环境或在线测试确认账号的实际参数校验；
  3. 如果 VIN 返回多个候选，先确认 carid，不要自动选择第一条；
  4. 保存本次查询使用的是 VIN 还是车型 ID，便于解释结果来源。

官方示例采用如下结构：

GET https://api.jisuepc.com/parts2/query
    ?carid=YOUR_CAR_ID
    &vin=
    &name=YOUR_PART_NAME
    &number=
    &appkey=YOUR_APPKEY

这是未执行的安全模板。APPKEY 只应保存在服务端，真实 VIN、配件号和客户工单信息也不应进入公开日志。

零件名称和零件号如何选择

不知道编号时先用零件名称，已有完整或部分编号时优先使用零件号。官方参数说明中，name 为零件名，至少 2 个字，并与 number 至少选择一个；错误码 203 对应“零件名太短”，205 对应“零件号为空”。

可以按输入条件分流：

已有信息 推荐输入 处理重点
只有通用名称 name 使用不少于 2 个字的具体名称，避免“件”“盖”等过宽词
有旧件完整编号 number 保留原始空格、连字符和后缀，另建规范化检索值
名称和编号都有 两者按联调规则组合 记录原始输入，确认接口是交集还是模糊条件后再上线
两者都没有 不提交 先补充配件位置、名称、图片或旧件编号

参数表证明名称和编号是两个查询入口，但没有说明同时传入时的组合逻辑。生产系统不能自行宣称一定按“且”或“或”处理，应以当前真实响应联调确认；未确认前可以只启用一种检索条件，减少歧义。

返回结果怎样进入候选清单

官方返回字段包括零件名 name、零件号 number、车型 ID、VIN、零件 ID partsid、英文名称、标准名称、品牌 ID、组代号、图片、重量、单位、价格、市场价、起止时间和品牌名称。

其中 isvinparts 用于区分数据来源：文档说明 1 表示 VIN 的精准件，0 表示车型数据。系统可以把它保存为“查询来源标记”，但不能仅凭该值向用户承诺绝对适配。

候选结果建议至少保留：

search_id
输入 carid / 脱敏 VIN
原始 name / number
partsid、零件号、品牌、组代号
isvinparts
查询时间与数据快照
人工状态：待核对 / 已确认 / 已排除

价格和市场价属于查询时点数据，应与正式报价、库存和成交价分开。起止时间字段也应保留原值，不能脱离官方语义自行解释为所有市场的生产有效期。

常见错误如何处理

该接口列出的业务错误包括 201“VIN 不正确”、202“VIN 无法锁定车型”、203“零件名太短”、204“车型 ID 错误”、205“零件号为空”和 220“没有信息”。

前端可以转成可执行提示：

  • 201/202：检查 VIN，必要时回到车辆确认流程；
  • 203：要求输入更具体的零件名称；
  • 204：重新选择具体车款，不把车系 ID 当作 carid；
  • 205：检查编号分支的输入和请求构造；
  • 220：保留无信息状态，转到 EPC 分组、OE 查询、图片或人工查件，不虚构候选。

系统错误则由后端处理 APPKEY、权限、配额、IP 和接口维护状态。对超时和维护状态使用有限重试，不能无限调用。

查询结果为什么还要复核

车型内搜索的作用是缩小候选，不是完成采购结论。左右侧、颜色、配置、生产批次、替换件关系和实物差异都可能影响最终选择。进入报价、采购或安装前，应继续核对 VIN/车型、OE 号、零件位置、旧件编号和实物信息。

总结

车型零件搜索 API 的接法是先确认车辆范围，再在零件名称和零件号之间选择输入，按 partsid、编号、品牌和 isvinparts 建立候选清单，最后进入人工或 EPC/OE 复核。对于 carid/VIN 的必填口径以及名称与编号同时传入的组合规则，上线前应通过当前官方文档和账号联调确认。

标签：