İki servis, tek entegrasyon
Değerleme API’si
Araç özelliklerini gönderin, fiyat aralığını alın. Güven skoru, örneklem büyüklüğü ve fiyatı etkileyen faktörlerin katkısı yanıta dahildir. Ortalama yanıt süresi 200 ms altı.
API detaylarıKatalog API’si
Normalize marka · model · nesil · motor · donanım hiyerarşisi. Kalıcı ID’ler ve alias eşlemesi ile veri kirliliği sorununu baştan çözer.
Veri seti detaylarıBeş dakikada ilk isteğiniz
Sandbox anahtarınızı aldıktan sonra ilk sorgunuza kadar tek adım var. Kimlik doğrulama standart Bearer token, veri formatı JSON.
- Sandbox anahtarı talep edin — ücretsiz, taahhütsüz
- Dokümantasyon ve Postman koleksiyonunu alın
- İlk isteğinizi gönderin
- Doğrulama sonrası production anahtarına geçin
Not: Sandbox ortamı gerçek veri döner, yalnızca hız limiti düşüktür. Böylece entegrasyonu gerçek sonuçlarla test edersiniz.
// Node.js — değerleme sorgusu
const res = await fetch('https://api.datadeger.com/v1/valuation', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DD_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
brand: 'Volkswagen',
model: 'Passat',
year: 2019,
km: 128000
})
});
const data = await res.json();
console.log(data.market_price); // 1195000
console.log(data.confidence); // 0.93Uç noktalar
| Metot ve yol | Açıklama | Not |
|---|---|---|
POST /v1/valuation | Tek araç değerleme | Ortalama yanıt < 200 ms |
POST /v1/valuation/bulk | Toplu değerleme | İstek başına 500 araca kadar |
GET /v1/brands | Marka listesi | Sayfalama destekli |
GET /v1/models?brand_id= | Markaya bağlı modeller | Nesil bilgisiyle |
GET /v1/trims?model_id= | Donanım paketleri | Motor ve şanzıman kırılımı |
GET /v1/match?q= | Serbest metinden araç eşleme | Alias tablosu üzerinden |
POST /v1/webhooks | Webhook kaydı | Fiyat değişimi bildirimi |
Tam OpenAPI şeması ve Postman koleksiyonu sandbox erişimiyle birlikte paylaşılır.
Üretim ortamı için hazır
Kimlik doğrulama
JWT tabanlı Bearer token, ortam bazlı anahtarlar (sandbox / production), IP allowlist desteği.
Hız limiti
Paket bazlı istek limiti; X-RateLimit-* başlıklarıyla kalan kotanızı anlık görürsünüz.
Idempotency
Toplu işlemlerde Idempotency-Key desteği; ağ hatası sonrası güvenli yeniden deneme.
Webhook
İmzalı payload (HMAC), otomatik yeniden deneme ve teslim günlüğü.
Hata sözleşmesi
Standart HTTP kodları ve makine tarafından okunabilir error.code alanı — belirsiz hata mesajı yok.
Kullanım paneli
İstek hacmi, hata oranı, ortalama yanıt süresi ve kalan kota tek ekranda.
Beyaz etiket kullanım — veri sizin ürününüzün parçası olur
Kurumsal lisans kapsamında beyaz etiket (white-label) kullanım hakkı sunuyoruz. Yani veriyi kendi arayüzünüzde, kendi markanızla son kullanıcılarınıza sunabilirsiniz.
Yazılım firmaları için tipik senaryolar:
- Galeri yazılımı geliştiricileri — kendi ERP’nize değerleme modülü ekleme
- İlan platformları — ilan verirken kullanıcıya fiyat önerisi gösterme
- Sigorta ve finans yazılımları — teminat ve poliçe bedeli hesaplama
- Filo yönetim sistemleri — kalıntı değer tahmini
- Mobil uygulamalar — tüketiciye yönelik araç değerleme aracı
Veriyi ham haliyle yeniden satmak ayrı bir dağıtım sözleşmesi gerektirir. Kullanım senaryonuzu paylaşın, uygun modeli birlikte belirleyelim.
Entegrasyon desteği
Yazılım firmalarına teknik destek kanalı açıyoruz — dokümantasyonda takıldığınız yerde geliştiriciyle konuşursunuz, destek formu doldurmazsınız.
- OpenAPI şeması ve Postman koleksiyonu
- PHP, Node.js, Python, C# örnek kodları
- Mevcut veritabanınızla eşleme çalışması
- Kurumsal pakette adanmış teknik hesap yöneticisi
Sıkça Sorulan Sorular
Ücretsiz deneme var mı?
Evet. Sandbox ortamında sınırlı sayıda ücretsiz sorgu hakkı tanımlıyoruz ve sandbox gerçek veri döner — yalnızca hız limiti düşüktür. Böylece entegrasyonu sahte veriyle değil, gerçek sonuçlarla test edersiniz. Formdan talep edebilirsiniz.
SLA ve uptime taahhüdü veriyor musunuz?
Kurumsal pakette tanımlı uptime ve yanıt süresi taahhüdü ile destek SLA’sı sözleşmeye eklenir. Başlangıç ve profesyonel paketlerde altyapı aynıdır ancak sözleşmesel taahhüt yer almaz. Kullanım paneli üzerinden gerçek hata oranı ve yanıt süresi metriklerinizi her zaman görebilirsiniz.
Veriyi kendi tarafımda önbelleğe alabilir miyim?
Katalog verisi (marka, model, donanım) için evet — hatta öneriyoruz; bu veri sık değişmez ve webhook ile değişiklikten haberdar olursunuz. Değerleme sonuçları ise piyasaya bağlı olarak değiştiği için uzun süreli önbellekleme önerilmez; makul bir TTL üzerinde birlikte karar veririz. Önbellekleme kuralları lisans sözleşmesinde nettir.
Fiyatlandırma nasıl işliyor?
Değerleme için yıllık sorgu hacmine göre paket seçilir (10.000 / 50.000 / sınırsız). Katalog verisi yıllık lisans, ömür boyu lisans veya API çağrı bazlı olarak lisanslanabilir. Yazılım firmaları genellikle katalogda yıllık lisans + değerlemede hacim paketi kombinasyonunu tercih ediyor. Senaryonuzu paylaşın, net rakam verelim.
Kendi müşterilerime yeniden satabilir miyim?
Beyaz etiket kullanım — yani kendi ürününüzün parçası olarak sunmak — kurumsal lisansa dahildir. Veriyi ham haliyle bağımsız bir ürün olarak yeniden satmak ise ayrı bir dağıtım anlaşması gerektirir. Bu durumda iş ortaklığı programımızı incelemenizi öneririz.
Dokümantasyon herkese açık mı?
Tam teknik dokümantasyon, OpenAPI şeması ve Postman koleksiyonu sandbox erişimiyle birlikte paylaşılır. Bunun nedeni kısıtlama değil, dokümantasyonun anahtarınıza özel örnekler ve kota bilgisi içermesidir. Erişim talebi ücretsizdir ve taahhüt gerektirmez.
Sandbox anahtarınızı alın, bugün deneyin
Ücretsiz, taahhütsüz ve gerçek veriyle. Entegrasyonda takılırsanız geliştiricimizle doğrudan konuşursunuz.