Test API anahtarı alın
Nasıl başlanır
Formu doldurun
Proje adınızı, e-posta adresinizi ve API'mizi kullanmayı planladığınız web sitesinin URL'sini girin. Henüz bir web siteniz yoksa bu alanı boş bırakın.
API anahtarınızı alın
Demo API anahtarınız e-posta adresinize gönderilecektir.
İlk isteği gönderin
Yapay zekâ için optimize edilmiş uç noktalarımızı denemek için kod örneğini kullanın: eksiksiz araç verileri için /trims/{id}/full veya doğal dilde arama için /search/vehicles.
Uygulamanızı geliştirin
Dokümantasyonumuzu ve SDK'mızı kullanarak araç verilerini uygulamanıza veya web sitenize entegre edin.
Yapay zekâ destekli aramayı deneyin
Doğal dilde aramamızı test edin: bir aracı düz metinle tarif edin ve temel teknik özellikleriyle birlikte ilgili sonuçları alın — sohbet botları ve yapay zekâ asistanları için ideal.
Hızlı başlangıç kod örneği
Bu kodu kopyalayın ve YOUR_API_KEY değerini test anahtarınızla değiştirin. Örnekler, birleştirilmiş uç noktaları (/full) ve akıllı aramayı gösterir — yapay zekâ/LLM uygulamaları için optimize edilmiştir.
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!
GitHub'da kullanıma hazır 40+ örnek
GitHub örneklerini görüntüleyinDemo ve tam API arasındaki farklar
| Özellik | Demo API | Tam API |
|---|---|---|
| Veriler | 2 üretici | 109 binden fazla araç |
| Birleştirilmiş uç noktalar (/full) | ||
| Akıllı arama (/search/vehicles) | ||
| İçerik haritası (breadcrumbs) ve temel teknik özellikler | ||
| Veri güncellemeleri | Sabit anlık görüntü | Aylık güncellemeler |
| Erişilebilirlik SLA'sı | SLA yok | %99,9 |
| Kullanım amacı | Test ve değerlendirme | Canlı (production) uygulamalar |
| Fiyat | ÜCRETSİZ | Ücretli |
Sıkça sorulan sorular
Demo API'de hangi veriler yer alıyor?
Demo API, 2 üreticinin (ör. Audi ve BMW) mevcut tüm modelleri, nesilleri, serileri ve versiyonlarıyla birlikte eksiksiz teknik özelliklerini içerir. Tam API'de olduğu gibi araç başına 80 teknik özelliğe erişirsiniz.
Demo API anahtarı ne kadar süre geçerlidir?
Demo API anahtarınız 1 yıl geçerlidir.
Demo API'yi canlı ortamda kullanabilir miyim?
Hayır, demo API anahtarları yalnızca test ve değerlendirme amaçlıdır. Sınırlı veriler (2 üretici) ve istek sınırları, bunları canlı kullanım için uygunsuz kılar. Canlı ortama geçiş için tam API planına yükseltin.
Tam API'ye nasıl yükseltebilirim?
Fiyatlar sayfamızı ziyaret edip API Aboneliği planını seçmeniz yeterli. Demo API anahtarınız, ödemenin hemen ardından tam üretim anahtarına yükseltilir.
Demo API anahtarım, üretim anahtarlarıyla aynı formatta mı?
Evet, demo anahtarı ücretli anahtarlarla aynı kimlik doğrulama mekanizmasını ve aynı API uç noktalarını kullanır; böylece kodunuzu değiştirmeden kolayca yükseltebilirsiniz.
Test için ek üreticiler talep edebilir miyim?
Demo anahtarlar önceden seçilmiş 2 üreticiyle sınırlıdır. Diğer araç modellerini etkileşimli demoda görebilirsiniz.
Yeni birleştirilmiş uç noktaları demo anahtarıyla test edebilir miyim?
Demo API tüm yeni özellikleri içerir: /trims/{id}/full ve /equipments/{id}/full birleştirilmiş uç noktaları, içerik haritası (breadcrumbs) ve keySpecifications. Yapay zekâ için optimize edilmiş yanıt yapısının tamamını test edebilirsiniz.
Araç aramayı demo anahtarıyla test edebilir miyim?
Evet, /search/vehicles uç noktası demo API'de kullanılabilir. Yapay zekâ destekli arama işlevini test etmek için "Audi A4 2.0" veya "BMW X5 diesel" gibi doğal dil sorgularını deneyin.
