呼叫價格
免費
快速接入
保持統一返回結構,直接透過服務端發起請求即可接入。
https://openapi.toolkk.com/v1/vehicle-seven-info-querycURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/vehicle-seven-info-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "plate": "京A12345",\n "veh_type": "02"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/vehicle-seven-info-query"
payload = {
"plate": "京A12345",
"veh_type": "02"
}
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-seven-info-query"
payload := []byte("{\n \"plate\": \"京A12345\",\n \"veh_type\": \"02\"\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 \"plate\": \"京A12345\",\n \"veh_type\": \"02\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/vehicle-seven-info-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-seven-info-query';
$payload = "{\n \"plate\": \"京A12345\",\n \"veh_type\": \"02\"\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;響應示例
{
"isFee": "数据源业务标记,成功样例为字符串1;不代表调用方账户扣费金额",
"result": "数据源业务结果说明",
"engine_no": "发动机号",
"car_usage": "使用性质",
"car_level": "车辆级别",
"brand_name": "车辆品牌",
"vin": "车架号/车辆识别代号",
"initial_registration_date": "初次登记日期,不等于生产日期",
"engine_model": "发动机型号",
"model_no": "车辆型号",
"car_type": "车辆类型"
}範例用於理解回傳結構,實際結果以介面回傳為準。
- 鑑權方式
- 請求頭傳入 X-API-Key
- 預設限流
- 60 次/分鐘
- 超時時間
- 10000 ms
服務端呼叫時,將 API Key 放在 X-API-Key 請求頭中。
建議按 response code 與業務欄位雙重判斷呼叫結果。
高頻呼叫場景請結合速率限制與重試策略使用。
請求欄位
從伺服器發起請求,並在 X-API-Key 標頭中傳入金鑰。
請求欄位
欄位來自介面結構定義。未提供的說明和範例會標為未標註。
| 欄位路徑 | 型別 | 必填 | 說明 | 示例值 |
|---|---|---|---|---|
| plate | string | 是 | 车牌号 | 京A12345 |
| veh_type | string | 是 | 车牌号码类型:01 商用车 02 乘用车 非必传默认02;本 Product 要求显式提供,避免依赖源文档存在冲突的默认行为。 | 02 |
請求示例
{
"plate": "京A12345",
"veh_type": "02"
}- 鑑權方式
- 請求頭傳入 X-API-Key
- 預設限流
- 60 次/分鐘
- 超時時間
- 10000 ms
響應欄位
範例用於理解回傳結構,實際結果以介面回傳為準。
響應欄位
欄位來自介面結構定義。未提供的說明和範例會標為未標註。
| 欄位路徑 | 型別 | 必填 | 說明 | 示例值 |
|---|---|---|---|---|
| isFee | string | 否 | 数据源业务标记,成功样例为字符串1;不代表调用方账户扣费金额 | 未標註 |
| result | string | 否 | 数据源业务结果说明 | 未標註 |
| engine_no | string | 否 | 发动机号 | 未標註 |
| car_usage | string | 否 | 使用性质 | 未標註 |
| car_level | string | 否 | 车辆级别 | 未標註 |
| brand_name | string | 否 | 车辆品牌 | 未標註 |
| vin | string | 否 | 车架号/车辆识别代号 | 未標註 |
| initial_registration_date | string | 否 | 初次登记日期,不等于生产日期 | 未標註 |
| engine_model | string | 否 | 发动机型号 | 未標註 |
| model_no | string | 否 | 车辆型号 | 未標註 |
| car_type | string | 否 | 车辆类型 | 未標註 |
響應示例
{
"isFee": "数据源业务标记,成功样例为字符串1;不代表调用方账户扣费金额",
"result": "数据源业务结果说明",
"engine_no": "发动机号",
"car_usage": "使用性质",
"car_level": "车辆级别",
"brand_name": "车辆品牌",
"vin": "车架号/车辆识别代号",
"initial_registration_date": "初次登记日期,不等于生产日期",
"engine_model": "发动机型号",
"model_no": "车辆型号",
"car_type": "车辆类型"
}$.status == 0 && $.data.isFee == '1'介面簡介
介面功能、應用情境、使用限制與常見問題。
介面能力
依中國大陸車牌號及號牌類型查詢車輛基本資料,結果可能含品牌、車輛型號、車身號碼、引擎號碼、引擎型號、首次登記日期、使用性質、車輛類型與級別。「7項」是服務名稱,實際欄位依回應定義及回傳內容判斷。此介面使用車牌定位紀錄,不接受用車身號碼取代車牌,也沒有車牌照片辨識功能。
應用情境
車輛建檔頁面可先顯示查詢資料,經人員核對後填入檔案;管理中國大陸車隊的系統可整理已知車牌的基本資訊;中古車資料頁可將回傳內容與車籍文件並列,協助逐項檢視。比對、去重及差異提示須由呼叫端處理,品牌或型號相近不能直接證明是同一部車。
呼叫與結果判讀
以 POST 提交完整車牌及號牌類型。類型依文件使用 01 商用車或 02 乘用車,建議明確填寫。確認查詢成功後讀取 data 物件,分開保存引擎號碼與引擎型號。首次登記日期代表登記時點,不能直接視為出廠日期;各種識別號碼應以字串儲存,保留英文字母及開頭的零。
範圍與限制
目前沒有臺灣、日本或其他地區號牌的適用承諾,也不保證中國大陸所有車種、歷史車牌或欄位都有紀錄。介面未提供車主姓名、聯絡方式、里程、事故與維修保養明細,也不產生估價。缺漏值須保留為未知;查詢失敗不等於車輛不存在,仍須搭配原始文件及現車查核。
常見問題
可以輸入車身號碼查詢嗎?
輸入是車牌及號牌類型,vin 是可能回傳的車身號碼。不能將此介面當作 VIN 解碼或反查車牌服務。
號牌類型一定要填嗎?
此 Product 列為必填。來源的必填標記與預設 02 的文字說明有差異,請明確提供 01 或 02。
引擎號碼與引擎型號相同嗎?
不同。engine_no 對應引擎號碼,engine_model 對應引擎型號,應分別保存及顯示。
沒有資料就代表車牌無效嗎?
不能如此判斷。先確認呼叫是否成功,再核對車牌與類型;收錄範圍或服務狀態也可能影響結果。