API Erişimi

EV Manual verilerini tanı araçlarınıza, servis yönetim sistemlerinize veya e-ticaret platformlarınıza entegre edin. İş ortağı hizmetleri üç biçimde sunulur — ürününüze uyanı seçin:

Veri alanları

API dört veri alanını açar — VIN çözümleme, teknik kartlar, onarım kılavuzları ve DTC aramalı devre şemaları — ve her yanıt, web arayüzünde görünenle aynı eşleşme düzeyi meta verisini içerir. Sonuç olarak bir entegratör, güven bilgisini ekstra mantık yazmadan son kullanıcılara sunabilir.

Kimlik doğrulama ve faturalama

Her istek, bir API anahtar çifti ve zaman damgasını ile istek gövdesini kapsayan HMAC-SHA256 imzasıyla doğrulanır; bu da yineleme saldırılarını ve yetkisiz kullanımı önler. Faturalama kullanım başınadır: çağrılar ölçülür ve token bakiyenizden düşülür; hacim kademeleri, kullanım büyüdükçe birim fiyatı otomatik olarak düşürür.

• Her iş ortağı bir API anahtar çifti alır; istekler HMAC-SHA256 ile imzalanır ve zaman damgalıdır.
• Kullanım başına ödeme: çağrılar ölçülür ve token bakiyenizden düşülür; hacim kademeleri birim fiyatı düşürür.
• Limitler kademenizle ölçeklenir, böylece onarım oturumu sırasında sorgu yapan bir tanı aracı asla takılmaz.
• SLA: API arka ucu, herkese açık statik siteden bağımsız olarak yalıtılmış bir VPS üzerinde çalışır.

Entegrasyon kılavuzu

Tipik bir entegrasyon bir ila beş iş günü sürer: ücretsiz hesap açın, iş ortaklığı sayfasından test kimlik bilgileri isteyin ve imza akışını doğrulamak için bilinen bir VIN ile sandbox uç noktasını çağırın. Örneğin 2019 model bir Toyota Camry VIN’inin çözümlenmesi, model sürümünü, 8 karakterli VIN önekini ve teknik karta bağlantıyı tek bir JSON yanıtında döndürür.

1. /shop/register.html adresinde ücretsiz hesap açın — bu, faturalama kimliğiniz olur.
2. İş Ortaklığı üzerinden kimlik bilgilerini isteyin; test anahtarları bir iş günü içinde verilir.
3. İstekleri timestamp + method + path + body üzerinden HMAC-SHA256 ile imzalayın; Python ve JavaScript’te referans imzalayıcı sağlanır.
4. Taban URL’yi değiştirerek yayına geçin; kullanım, web mağazasıyla aynı token cüzdanına ölçülür.

Çoğu iş ortağı entegrasyonu üç referans VIN ile doğrular — biri tam önek eşleşmesi, biri WMI geri dönüşü, biri marka düzeyi adayı — çünkü bu üç durum, çözümleyicinin izleyebileceği her kod yolunu çalıştırır.

Kullanım senaryoları

Mevcut entegrasyonlar; taramadan önce VIN çözümleyen bir Avrupa tanı aracı üreticisini, ilanları model sürümleriyle eşleştiren bir parça pazar yerini ve tüm veri merkezini beyaz etiket CNAME altında çalıştıran bir bayi grubunu içerir. Her durumda entegrasyon yüzeyi aynıdır — yalnızca faturalama profili farklıdır. Üçü için de veri tazeliği herkese açık siteyle aynıdır, çünkü API yanıtları 15 Ekim 2026 tarihinde güncellenen aynı veri setinden sunulur.

• Tanı araçları — önce aracı tanımlayın, ardından modele özel DTC tanımlarını ve devre şemalarını yükleyin.
• Parça e-ticareti — müşteri VIN’ini tam model sürümüne eşleyerek yanlış parça iadelerini ortadan kaldırın.
• Bayi portalları — servis müşterilerini beyaz etiketli atölye dokümantasyonuyla bayi sitesinde tutun.

Sandbox ve test

Her entegrasyon, üretim veri şeklini yansıtan ancak sabit bir referans VIN setiyle yanıt veren ücretsiz bir sandbox’ta başlar, böylece tek bir token harcamadan geliştirip test edebilirsiniz. Ayrıca sandbox, üretimle aynı eşleşme düzeyi meta verisini döndürür; yani güven gösterimi mantığınız, yayına geçmeden önce gerçek geri dönüş durumlarına karşı test edilir.

• Ücretsiz test anahtarları — İş Ortaklığı üzerinden bir iş günü içinde verilir; sözleşme veya hacim taahhüdü gerekmez.
• Referans VIN’ler — tam önek eşleşmeleri, WMI geri dönüşleri ve marka düzeyi adayları kapsayan, her eşleşme düzeyinden biri olacak şekilde belgelenmiş bir set.
• Referans imzalayıcılar — Python ve JavaScript’te kopyala-yapıştır HMAC-SHA256 imzalama örnekleri, artı duman testleri için bir Postman koleksiyonu.
• Sıfır maliyetli test — sandbox çağrıları asla ölçülmez; üretim faturalaması yalnızca taban URL’yi değiştirdikten sonra başlar.

Sık sorulan sorular