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 <token>
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 kadarWebhook
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 ö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.