# Veri Entegrasyonu ile Anlık Araç Fiyat Sorgulama

> Değerleme verisini sitenize veya yazılımınıza bağlamanın yolları: hazır form, REST API, toplu sorgu ve webhook. Kurulum süreleri ve teknik gereksinimler.

**Kaynak:** https://datadeger.com/data-entegrasyonu-ile-anlik-arac-fiyat-sorgulama/
**Yayın:** 22 Ağustos 2025 · **Okuma:** 2 dk · **Konu:** Veri & API, Araç Değerleme
**Yayıncı:** Data Değer — https://datadeger.com/

---

Anlık fiyat sorgulama, arkasında güncel bir veri kaynağı olmadan çalışmaz. Bu yazıda değerleme verisini kendi sisteminize bağlamanın yollarını, teknik gereksinimleri ve kurulum sürelerini ele alıyoruz.

## Dört bağlanma yolu

 
 
 Yöntem Kime uygun Kurulum 
 
 Hazır form (embed) Teknik ekibi olmayan galeriler Tek satır kod, aynı gün 
 REST API Kendi arayüzünü kuracak ekipler 1–3 iş günü 
 Toplu sorgu (bulk) Stok denetimi yapanlar Zamanlanmış görev 
 Webhook Fiyat değişiminde uyarı isteyenler 1–2 iş günü 
 
 
 

## Hazır form

En hızlı yol. Sitenizin istediğiniz yerine tek bir kod parçası eklersiniz; form, sonuç ekranı ve lead toplama hazır gelir.

 

- Teknik bilgi gerektirmez

- Görünüm sitenizin renklerine uyarlanabilir

- Gelen lead’ler e-posta ve panel üzerinden iletilir

- Dezavantaj: özelleştirme sınırlı

## REST API

Kendi arayüzünüzü kuracaksanız doğru yol budur. Standart REST + JSON; kimlik doğrulama Bearer token.

`POST /v1/valuation
Authorization: Bearer 
Content-Type: application/json

{
 "brand": "Volkswagen",
 "model": "Passat",
 "trim": "1.6 TDI Impression",
 "year": 2019,
 "km": 128000,
 "damage_record": 42000,
 "city": "34"
}` 
 Yanıt; alım, piyasa ve hızlı satış fiyatlarının yanında güven skoru, örneklem büyüklüğü ve fiyatı etkileyen faktörlerin katkısını içerir.

> Marka ve model listelerini de API’den alın: GET /v1/brands , /v1/models , /v1/trims . Böylece açılır listeleriniz her zaman güncel kalır ve normalize veri sayesinde eşleşme hatası oluşmaz.

## Toplu sorgu

Stoktaki tüm araçları tek istekte değerlemek için. Haftalık zamanlanmış bir görevle çalıştırıp piyasanın üzerinde kalan araçları raporlayabilirsiniz.

`POST /v1/valuation/bulk # istek başına 500 araca kadar` 

## Webhook

 Piyasa hareket ettiğinde sistemin sizi uyarması için. Stoktaki bir aracın piyasa değeri belirli bir eşiğin ötesinde değiştiğinde bildirim gönderilir.

## Teknik gereksinimler

 

- HTTPS — tüm istekler şifreli

- Kimlik doğrulama: Bearer token; sandbox ve production ayrı anahtarlar

- Hız limiti: Paket bazlı; X-RateLimit-* başlıklarıyla kalan kota görünür

- Idempotency: Toplu işlemlerde güvenli yeniden deneme

- Hata sözleşmesi: Standart HTTP kodları + makine okunur error.code

## Önbellekleme

Katalog verisi (marka, model, donanım) sık değişmez — önbelleğe alın, webhook ile değişiklikten haberdar olun. Değerleme sonuçları ise piyasaya bağlı değiştiği için uzun süreli önbellekleme önerilmez.

## Entegrasyon süreci

 

- Sandbox anahtarı — ücretsiz, gerçek veri döner, yalnızca hız limiti düşüktür

- Dokümantasyon ve Postman koleksiyonu

- Test — bilinen araçlarla sonuçları doğrulayın

- Production anahtarı ve canlıya alma

Teknik ekibi olan firmalarda bu süreç genelde birkaç saat sürer. [Geliştiriciler için sayfamızda](https://datadeger.com/gelistiriciler/) örnek kodlar ve uç nokta listesi bulunur.

## Özetle

Anlık fiyat sorgulama için dört farklı bağlanma yolu var; hangisini seçeceğiniz teknik kapasitenize ve özelleştirme ihtiyacınıza bağlı. Teknik ekibiniz yoksa hazır form aynı gün çalışır; kendi arayüzünüzü kuracaksanız REST API birkaç saatte bağlanır.

## Sıkça Sorulan Sorular

### Teknik ekibim yok, yine de kullanabilir miyim?

Evet. Hazır form seçeneğinde tek bir kod parçasını sitenize eklemek yeterli — bunu da biz yapabiliriz. Ayrıca web paneli üzerinden manuel sorgu da mümkündür; hiçbir entegrasyon gerektirmez.

### Sandbox gerçek veri mi döndürüyor?

Evet. Sandbox ortamı gerçek sonuçlar üretir; yalnızca hız limiti düşüktür. Böylece entegrasyonu sahte veriyle değil, gerçek sonuçlarla test edersiniz ve doğruluğu kendi araçlarınızla ölçebilirsiniz.

### API çağrılarım aniden artarsa ne olur?

Hız limitine ulaştığınızda istekler `429` yanıtı alır ve `X-RateLimit-Reset` başlığı ne zaman yeniden deneyebileceğinizi bildirir. Kalan kotanızı panelden ve yanıt başlıklarından anlık izleyebilirsiniz; hacim artışı bekliyorsanız paket yükseltmesi hemen yapılabilir.
