根据车架号查机油型号不宜只做一次字符串查询：先用 VIN 获取并确认具体车型，再按车型 ID 查询机油信息，保存参考用量、黏稠度、分类和质量等级。接口结果用于保养选型参考，不能替代车辆手册和实车复核。
为什么要拆成两步
极速车服 VIN 车辆识别代码查询 API在同一文档中提供 VIN 查询和“车型 ID 获取机油信息”两个端点。VIN 查询负责从车架号识别车辆并返回候选车型；机油端点则要求具体车型 ID carid。
这意味着“车架号查机油”在系统里更适合拆成：
输入 VIN
↓
调用 /vin/query 获取车辆与 carlist
↓
确认具体 carid
↓
调用 /vin/oil 查询机油字段
↓
保存规格快照并进入人工复核
如果 VIN 查询返回多个可能车型，不能直接把第一条候选传给机油接口。相同车系的不同年款、发动机或配置可能存在差异，先确认车型是后续规格查询的必要业务步骤。
第一步如何用 VIN 确认车型
VIN 查询端点为 https://api.jisuepc.com/vin/query，支持 GET、POST，必填参数是 vin，还可传 strict 和外部 ID 类型 caridtype。页面说明该接口为一对多返回，可能车型位于 carlist。
安全请求模板如下：
POST https://api.jisuepc.com/vin/query
appkey=YOUR_APPKEY
vin=YOUR_VIN
strict=0
该模板没有实际发起查询。接口调用可能受权限、配额和当前计费规则影响，使用前应查看官方页面并通过已授权数据联调。
系统收到结果后，应保留全部候选，并用年款、发动机、变速箱、车型名称和现车资料确认 carid。strict 只是 VIN 校验参数，不等于车型已经唯一确认；status=0 也只表示接口业务成功，不能代替人工或业务规则选车。
第二步怎样查询机油信息
车型确认后，调用文档中的机油端点：
GET https://api.jisuepc.com/vin/oil
?appkey=YOUR_APPKEY
&carid=YOUR_CAR_ID
官方参数表要求 carid，并说明它是车型大全接口中的车型 ID。不要传品牌 ID、车系 ID、EPC 分组 ID 或本地数据库自增 ID。接入车型大全时，应明确保存极速车服外部 carid 与本地车辆记录的映射。
机油查询返回字段包括：
| 字段 | 官方说明 | 业务处理建议 |
|---|---|---|
machineoil | 机油信息 | 保留原始文本，用于展示与检索 |
volume | 参考用量 | 单独标记“参考”，不要直接生成结算数量 |
viscosity | 粘稠度 | 保存原值，展示时不要自行改写标准 |
grade | 机油分类 | 与黏稠度分列保存 |
level | 质量等级 | 保留查询时间和数据来源 |
接口同时返回 carid、品牌、车系、车型、年款、上市时间和生产/销售状态等车辆上下文。建议把这些字段与机油规格存成同一快照，避免后续只看到一个黏度值，却不知道对应的是哪个具体车款。
数据库怎样避免车型串用
机油规格记录至少要关联三类身份：原始 VIN 请求、确认后的外部 carid、本地车辆或工单 ID。只用“品牌 + 车系”作为唯一条件，会让不同发动机和年款共享同一条规格。
可以采用下面的记录结构：
oil_query_id
vehicle_record_id
vin_hash / vin_masked
jisuepc_carid
car_name / yeartype
machineoil / volume / viscosity / grade / level
queried_at
confirmation_source
这里的表结构属于接入建议，不是官方接口规定。confirmation_source 可以记录“用户选择、行驶证核对、维修人员确认”等内部状态，但不要写成极速车服返回字段。
机油参考用量为什么不能直接变成订单数量
官方把 volume 定义为参考用量。维修中的实际加注还可能受到发动机具体状态、放油方式、是否更换滤芯、残留量和维修规范影响。因此可以将其用于方案预估和备料参考，但不应在没有复核的情况下自动生成最终收费数量。
机油信息、黏稠度、分类和等级也要作为组合查看，不能只抽取一个字段就判断可购买商品。产品 SKU 还会涉及品牌、包装规格、认证要求和门店库存，应由配件或维修流程继续确认。
查询失败怎样分层处理
VIN 文档列出的业务错误包括 201“VIN 为空”、202“VIN 不正确”和 210“没有信息”；系统错误包括 APPKEY 不存在、过期、无权限、请求超限、IP 限制、维护和停用。
机油查询使用同一产品文档，但页面没有单独列出一组仅针对 /vin/oil 的业务错误码。因此，正文不能擅自把 VIN 错误逐项归因到机油端点。实际接入时应分别记录端点、HTTP 状态、业务 status 和 msg，以真实响应判断错误对象。
推荐的失败出口是：
- VIN 无法确认车型：补充车辆资料或人工选择，不继续查机油；
carid映射缺失：回到车型同步或车辆确认流程；- 机油端点无结果：保留“暂无规格”状态，核对车辆手册或咨询维修人员；
- 鉴权、超限或维护：后端告警并有限重试，不向前端泄露 APPKEY。
与保养套餐接口怎样分工
只需要某车型的机油信息时，/vin/oil 是更窄的查询动作；需要结合里程、月数获取小保养等项目，再展开产品清单时，应使用车型保养套餐接口。前者聚焦机油规格，后者聚焦保养项目与产品明细，两者不应重复调用后再把结果无条件合并。
总结
根据车架号查机油型号的可靠流程是：VIN 查询生成车型候选，确认具体 carid，再调用 /vin/oil 获取机油信息、参考用量、黏稠度、分类和质量等级。结果要与车型快照一起保存，并在保养施工或商品采购前结合车辆手册、实车和维修规范复核。
