获取测试 API 密钥

测试 API 密钥将发送到您的电子邮件

How to Get Started

1

Fill the Form

输入您的项目名称、电子邮件和计划使用我们 API 的网站 URL。如果您还没有网站 - 留空即可。

2

Get Your API Key

您的演示 API 密钥将发送到您的电子邮件。

3

Make First Request

使用代码示例测试我们的AI优化端点:/trims/{id}/full获取完整车辆数据或/search/vehicles进行自然语言搜索。

4

Build Your App

使用我们的文档和 SDK 将车辆数据集成到您的应用程序或网站中。

5

尝试AI驱动搜索

测试我们的自然语言搜索:用简单文本描述车辆,获取带关键规格的相关结果——非常适合聊天机器人和AI助手。

Quick Start Code Example

复制此代码并将YOUR_API_KEY替换为您的测试密钥。示例展示了聚合端点(/full)和智能搜索——为AI/LLM应用优化。

const API_KEY = 'YOUR_API_KEY';

// One request replaces 6 separate API calls!
// Get full trim data: breadcrumbs + specs + equipments
const response = await fetch(
  'https://v3.api.car2db.com/trims/263119/full',
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Referer': 'https://yourwebsite.com'
    }
  }
);

const data = await response.json();
const trim = data.trim || data; // Handle both /full and regular response

// All data in one response:
console.log(trim.name);                    // → "2.5 AT"
console.log(trim.breadcrumbs?.make?.name);  // → "Toyota"
console.log(trim.breadcrumbs?.model?.name); // → "Camry"

// Key specs optimized for LLMs:
console.log(trim.keySpecifications?.engineVolume);  // → 2496
console.log(trim.keySpecifications?.power);         // → 200
console.log(trim.keySpecifications?.transmission);  // → "Automatic"

// All specifications grouped by category:
trim.specifications?.forEach(group => {
  console.log(group.category.name);  // → "Engine", "Transmission", etc
  group.items.forEach(spec => {
    console.log(`${spec.name}: ${spec.value}`);
  });
});
import requests

API_KEY = 'YOUR_API_KEY'

# Natural language search - find vehicles by description
headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Referer': 'https://yourwebsite.com'
}

response = requests.get(
    'https://v3.api.car2db.com/search/vehicles',
    headers=headers,
    params={'q': 'Toyota Camry 2.5 automatic'}
)

if response.status_code == 200:
    results = response.json()
    
    # Results grouped by models with relevance score
    for model in results.get('results', []):
        print(f"{model['model']['name']} ({model['matchingTrimsCount']} trims)")
        
        for trim in model.get('matchingTrims', []):
            print(f"  {trim['name']} ({trim['yearBegin']}-{trim['yearEnd']})")
            print(f"  Relevance: {trim['relevanceScore']}")
            
            # Key specs included in search results:
            specs = trim.get('keySpecifications', {})
            print(f"  Engine: {specs.get('engineVolume')}L {specs.get('power')}hp")
            print(f"  Transmission: {specs.get('transmission')}")
else:
    print(f"Error: {response.status_code}")
<?php
$apiKey = 'YOUR_API_KEY';

// Get trim with full context: breadcrumbs + key specs
// Replace 263119 with a real trim ID
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://v3.api.car2db.com/trims/263119/full');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer {$apiKey}",
    "Referer: https://yourwebsite.com"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
$trim = $data['trim'] ?? $data; // Handle both formats

if (isset($trim['breadcrumbs'])) {
    // Breadcrumbs provide full navigation context:
    $breadcrumbs = $trim['breadcrumbs'];
    echo "{$breadcrumbs['make']['name']} ";        // → "Toyota"
    echo "{$breadcrumbs['model']['name']} ";       // → "Camry"
    echo "{$breadcrumbs['generation']['name']} ";  // → "XV70"
    echo "{$trim['name']}\n";                      // → "2.5 AT"
    
    // Key specifications optimized for AI/LLM:
    $specs = $trim['keySpecifications'] ?? [];
    echo "Engine: {$specs['engineVolume']} cm\n";    // → "2496 cm"
    echo "Power: {$specs['power']}hp\n";           // → "200hp"
    echo "Drive: {$specs['drive']}\n";             // → "Front"
}
API_KEY="YOUR_API_KEY"

# Get equipment with ALL options grouped by category
curl -X GET "https://v3.api.car2db.com/equipments/54321/full" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Referer: https://yourwebsite.com"

# Response includes complete equipment data in one request:
{
  "equipment": {
    "id": 54321,
    "name": "Prestige",
    "breadcrumbs": {
      "make": { "id": 10, "name": "Toyota" },
      "model": { "id": 120, "name": "Camry" }
    }
  },
  "options": {
    "Safety": [
      { "name": "Airbags", "value": "8" },
      { "name": "ABS", "value": "Standard" }
    ],
    "Comfort": [
      { "name": "Climate Control", "value": "Dual-zone" },
      { "name": "Heated Seats", "value": "Front & Rear" }
    ],
    "Multimedia": [
      { "name": "Display", "value": "10.1 inch touchscreen" }
    ]
  }
}
# Zero-code AI Integration
# Connect Claude Desktop, Cursor, VS Code to Car2DB API

## Claude Desktop Configuration
# File: claude_desktop_config.json
{
  "mcpServers": {
    "car2db": {
      "command": "npx",
      "args": ["-y", "@car2db/mcp-server"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_LANGUAGE": "en-US"
      }
    }
  }
}

## GitHub Copilot / VS Code Configuration
# File: .vscode/mcp.json
{
  "mcpServers": {
    "car2db": {
      "command": "npx",
      "args": ["-y", "@car2db/mcp-server"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_LANGUAGE": "en-US"
      }
    }
  }
}

# Now ask AI: "Find specifications for Toyota Camry 2.5"
# AI will automatically use Car2DB API via MCP Server!

40+个即用示例可在GitHub上获取

查看GitHub示例

演示版和完整版 API 的区别

Feature 演示版 API 完整版 API
数据 2 manufacturers 109K+ 车辆
聚合端点 (/full)
智能搜索 (/search/vehicles)
Breadcrumbs 和 Key Specs
Data Updates Static snapshot Monthly updates
Uptime SLA 无 SLA 99.9%
Use Case Testing & evaluation Production apps
Price FREE 付费

Frequently Asked Questions

What data is included in the demo API?

The demo API includes complete specifications for 2 manufacturers (e.g., Audi and BMW) with all available models, generations, series, and trims. You get access to 80 technical specifications per vehicle, just like the full API.

How long is the demo API key valid?

Your demo API key is valid for 1 year.

Can I use the demo API in production?

No, demo API keys are intended for testing and evaluation only. The limited data (2 manufacturers) and rate limits make them unsuitable for production use. Upgrade to a full API plan for production deployment.

How do I upgrade to the full API?

Simply visit our pricing page and choose the API Subscription plan. Your demo API key will be upgraded to a full production key immediately after payment.

Is my demo API key the same format as production keys?

是的,演示密钥使用与付费密钥相同的身份验证机制和相同的API端点,使得无需更改代码即可轻松升级。

Can I request additional manufacturers for testing?

Demo keys are limited to the 2 pre-selected manufacturers. Other vehicle models can be seen on the interactive demo.

我可以使用演示密钥测试新的聚合端点吗?

演示API包含所有新功能:聚合端点 /trims/{id}/full 和 /equipments/{id}/full、breadcrumbs 和 keySpecifications。您可以测试为AI优化的完整响应结构。

我可以使用演示密钥测试车辆搜索吗?

可以,/search/vehicles端点可以与演示API一起使用。尝试自然语言查询,例如"Audi A4 2.0"或"BMW X5 diesel",测试AI驱动的搜索功能。

Car2DB Support