调用价格
15 匠币/次
快速接入
保持统一返回结构,直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/vehicle-vin-querycURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/vehicle-vin-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "vin": "LFV2A21K7J3001234"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/vehicle-vin-query"
payload = {
"vin": "LFV2A21K7J3001234"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/vehicle-vin-query"
payload := []byte("{\n \"vin\": \"LFV2A21K7J3001234\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"vin\": \"LFV2A21K7J3001234\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/vehicle-vin-query"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/vehicle-vin-query';
$payload = "{\n \"vin\": \"LFV2A21K7J3001234\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"brand": "大众",
"model": "帕萨特",
"year": "2018",
"engine": "1.8T",
"fuel": "汽油",
"transmission": "自动"
}
}示例用于理解返回结构,实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 600 次/分钟
- 超时时间
- 10000 ms
服务端调用时,将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求,并在 X-API-Key 请求头中传入密钥。
请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| vin | string | 未标注 | 未标注 | LFV2A21K7J3001234 |
请求示例
{
"vin": "LFV2A21K7J3001234"
}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 600 次/分钟
- 超时时间
- 10000 ms
响应字段
示例用于理解返回结构,实际结果以接口返回为准。
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| code | string | 未标注 | 未标注 | SUCCESS |
| message | string | 未标注 | 未标注 | success |
| data | object | 未标注 | 未标注 | {...} |
| data.brand | string | 未标注 | 未标注 | 大众 |
| data.model | string | 未标注 | 未标注 | 帕萨特 |
| data.year | string | 未标注 | 未标注 | 2018 |
| data.engine | string | 未标注 | 未标注 | 1.8T |
| data.fuel | string | 未标注 | 未标注 | 汽油 |
| data.transmission | string | 未标注 | 未标注 | 自动 |
响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"brand": "大众",
"model": "帕萨特",
"year": "2018",
"engine": "1.8T",
"fuel": "汽油",
"transmission": "自动"
}
}接口简介
接口能力、应用场景、使用限制与常见问题。
按 VIN 查询车辆资料
输入车辆识别码 VIN,接口查询关联的基础车型与动力信息。公开响应示例包含品牌、车型、年份、发动机、燃料类型和变速箱,可用于补全车辆资料、缩小后续检索范围。基础属性查询不能替代车辆历史、权属或交易状态核验,也不应仅凭车型相同就合并车辆档案。
应用场景
- 车辆资料录入:将查询结果预填到表单,交由用户结合证件确认。
- 维修接车:取得车型和动力信息后,作为人工配件选型或维修资料检索的线索。
- 车队管理:补充资产记录的基础属性,缺项或未命中时转人工核对;资料维护规则由业务系统决定。
使用与结果解读
从车辆铭牌或原始资料取得完整编号,核对抄录后放入 vin。先根据 code 与 message 判断请求状态,成功后读取 data。brand、model 和 year 用于车型资料对照,engine、fuel 与 transmission 用于动力信息展示。应允许部分属性缺失,不将查询成功理解为所有信息齐全。
覆盖与复核
当前公开定义没有给出完整品牌、年款和地区覆盖清单,也没有统一刷新周期承诺,不能保证每个 VIN 都能命中。返回资料与车辆原件不一致时,保留原始查询结果并向厂商或相关渠道核对。配件匹配、保险或车辆交易还需结合实际配置和证件,不能单靠这些基础属性作出最终判断。