车辆 VIN 解码

通过美国 NHTSA vPIC 数据库把车辆识别码（VIN）解码为品牌、车型、年款、配置、车身、制造商、产地、燃料、发动机和驱动形式。


接口	`POST /v1/vehicle-vin-decodes`
所需权限	`vehicle_vin:decode`
MCP 工具	`vehicle_vin`
计量单位	`vins`

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

字段	类型	必填	说明
`invocation_id`	string	是	调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
`provider`	string	是	处理本次请求的数据源，按下方数据源表的覆盖范围选择。可选值：`nhtsa`
`vin`	string	是	车辆识别码，11–17 个字符，可用 A-Z（不含 I、O、Q）、0-9，未知位用 *。
`model_year`	integer	否	可选，年款提示，1980 到今年之后两年。

数据源

数据源	区域	说明	限制
`nhtsa`	US	美国 NHTSA vPIC 数据库	`timeout_seconds`: 30

示例

curl -sS https://services.zgi.im/v1/vehicle-vin-decodes \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-vehicle_vin", "provider": "nhtsa", "vin": "1HGCM82633A004352"}'

POST /v1/vehicle-vin-decodes HTTP/1.1
Host: services.zgi.im
Authorization: Bearer <token>
Content-Type: application/json

{
  "invocation_id": "docs-1791778521-vehicle_vin",
  "provider": "nhtsa",
  "vin": "1HGCM82633A004352"
}

通过 MCP 调用时，工具参数与 HTTP 请求体完全相同。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vehicle_vin",
    "arguments": {
      "invocation_id": "docs-1791778521-vehicle_vin",
      "provider": "nhtsa",
      "vin": "1HGCM82633A004352"
    }
  }
}

curl -sS https://services.zgi.im/v1/mcp \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d @request.json

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e52bfb6798fb083caceaba10ed8",
      "invocation_id": "docs-1791778521-vehicle_vin",
      "capability": "vehicle_vin",
      "operation": "vehicle_vin.decode",
      "provider": "nhtsa",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "vins",
            "value": 1,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_d4b3b5ce0cf30ce74377cf7a",
      "started_at": "2026-10-12T04:15:37.398623396Z",
      "finished_at": "2026-10-12T04:15:37.792749167Z",
      "duration_ms": 394
    },
    "result": {
      "vin": "1HGCM82633A004352",
      "complete": true,
      "vehicle": {
        "make": "HONDA",
        "model": "Accord",
        "model_year": "2003",
        "trim": "EX-V6",
        "body_class": "Coupe",
        "vehicle_type": "PASSENGER CAR",
        "manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
        "plant_country": "UNITED STATES (USA)",
        "fuel_type": "Gasoline",
        "displacement_l": "2.998832712",
        "engine_cylinders": "6",
        "drive_type": null
      },
      "notes": [],
      "source": {
        "name": "NHTSA vPIC",
        "license": "US government public data",
        "url": "https://vpic.nhtsa.dot.gov"
      }
    }
  }
}