API & iframe

Araç veritabanımızı kendi sitenizde kullanın

Ana sayfamızdaki araç seçici ve dyno ekranını tek satır kodla sitenize ekleyin ya da tüm verileri API ile kendi sisteminize çekin. Marka, model, nesil, motor; orijinal ve Stage güç/tork, ECU ve motor bilgileri.

Teklif alın Canlı önizleme
  • 165+ Marka
  • 1.800+ Model
  • 3.100+ Nesil
  • 14.000+ Motor

İki kullanım yolu

Hazır ekran ya da ham veri — siz seçin

İkisi de aynı veritabanından beslenir ve aynı veriyi verir. Fark yalnızca nasıl kullandığınızdadır.

Kod bilgisi gerekmez

iframe — hazır araç seçici

Sitemizdeki araç seçici ve dyno ekranı, olduğu gibi sizin sitenizde. Verdiğimiz kodu sayfanıza yapıştırmanız yeterli.

  • Marka → model → nesil → motor seçimi
  • Stage 1 / Stage 2 kartları ve dyno grafiği
  • Açık/koyu tema, vurgu rengi ve dil (TR / EN / DE)
  • Seçilen araç sayfanıza bildirilir (formunuza aktarabilirsiniz)
Geliştiriciler için

API — ham JSON veri

Verileri kendi sunucunuzdan çekin; kendi tasarımınızla, kendi sisteminizde kullanın.

  • Basit REST uçları, JSON yanıt
  • Anahtar ile kimlik doğrulama (X-API-Key)
  • Sabit alan adları — sürümlü (/v1)
  • Günlük kota ve kullanım başlıkları

Canlı önizleme

Müşterilerinizin göreceği ekran

Aşağıdaki seçici, iframe ile sitenize eklenen ekranın aynısıdır. Bir araç seçip deneyin.

Seçiniz—

Dyno Eğrisi

Yazılım Seviyesi

Aracını seç — Stage değerleri ve dyno eğrisi burada oluşur.

Yazılım Seviyesi

iframe sürümünde motor kodu, ECU/TCU, bore/stroke, sıkıştırma, ayar yöntemi, Stage 3 ve E85 değerleri de açık görünür.

Veriler

Hangi verileri alırsınız?

Tek paket: her anahtar tüm verileri alır. Fiyat ve sipariş bilgisi verilmez — yalnızca araç verisi.

  • Araç ağacıKategori, marka, model, nesil ve motor; her biri sabit kimlikle.
  • Yakıt ve hacimBenzin, dizel, hibrit, elektrik, LPG; motor hacmi (cc).
  • YıllarNeslin başlangıç ve bitiş yılı.
  • Orijinal güç ve torkFabrika çıkışı beygir (HP) ve tork (Nm).
  • Stage 1-3 ve E85Yazılım sonrası güç ve tork değerleri.
  • ECU ve TCUMotor ve şanzıman beyni tipi.
  • Motor koduÜretici motor kodu.
  • Bore/stroke ve sıkıştırmaSilindir çapı × strok ve sıkıştırma oranı.
  • Ayar yöntemiYazılımın nasıl yüklendiği (ör. OBD, bench).

Fiyatlandırma

Net fiyat, gizli ücret yok

İkisi de yıllık abonelik; iframe'de ek olarak tek seferlik kurulum ücreti var. Veriler her pakette aynı: tüm araç verisi.

Kod bilgisi gerekmez

iframe

550 €/ yıl

+ 450 € tek seferlik kurulum

  • Hazır araç seçici + dyno ekranı
  • Tema, vurgu rengi ve dil ayarı
  • Sizin sitenize özel anahtar ve izinli site tanımı
  • Katalog güncellemeleri dahil
Teklif alın

Geliştiriciler için

API

1.750 €/ yıl

Kurulum ücreti yok

  • Tüm araç verisi, JSON, /v1 uçları
  • Kendi tasarımınız, kendi sisteminiz
  • Günlük kota ve kullanım izleme
  • Katalog güncellemeleri dahil
Teklif alın

Fiyatlar euro cinsindendir. Yüksek trafik için kotanızı birlikte belirleriz; iframe ve API'yi birlikte almak isterseniz bize yazın.

Nasıl başlarım?

Dört adımda sitenizde

  1. 01

    Bize ulaşın

    İhtiyacınızı (iframe ya da API) ve kullanacağınız site adresini iletin; tahmini kullanımınıza göre teklif hazırlayalım.

  2. 02

    Anahtarınızı alın

    Size özel anahtar oluşturur, site adresinizi tanımlar ve günlük kotanızı belirleriz.

  3. 03

    Sitenize ekleyin

    iframe için verdiğimiz kodu sayfanıza yapıştırın; API için geliştiriciniz uç noktalara bağlanır.

  4. 04

    Kullanın

    Katalog güncellendikçe yeni araçlar sitenizde de otomatik görünür. Kotanız gerekirse artırılır.

Geliştiriciler için

Teknik ayrıntılar

Kısa ve sabit bir sözleşme: anahtar başlıkta, yanıt JSON, alan adları sürümle sabit.

<iframe id="ats-vehicle"
  src="https://www.atsmapping.com/embed?key=ats_pk_ANAHTARINIZ&lang=tr&theme=light"
  width="100%" height="760" style="border:0" loading="lazy"
  title="ATS Mapping"></iframe>

<script>
  // İsteğe bağlı: yükseklik otomatik ayarlansın + seçilen aracı alın
  window.addEventListener('message', function (e) {
    if (e.origin !== 'https://www.atsmapping.com' || !e.data || e.data.source !== 'ats-vehicle') return;
    if (e.data.type === 'resize') document.getElementById('ats-vehicle').style.height = e.data.height + 'px';
    if (e.data.type === 'select') console.log(e.data.brand, e.data.model, e.data.generation, e.data.engine);
  });
</script>

Kimlik doğrulama

Her isteğe X-API-Key başlığını ekleyin. API anahtarı (ats_live_…) gizlidir, yalnızca sunucuda kullanın. iframe anahtarı (ats_pk_…) yalnızca size tanımlanan sitelerde çalışır.

Uç noktalar

  • GET /api/v1/meAnahtarınız, kotanız ve bugünkü kullanım
  • GET /api/v1/categoriesAraç kategorileri
  • GET /api/v1/brands?categoryId=…Markalar (kategoriye göre)
  • GET /api/v1/models?brandId=…Bir markanın modelleri
  • GET /api/v1/generations?modelId=…Bir modelin nesilleri
  • GET /api/v1/engines?generationId=…Bir neslin motorları ve tüm verileri

Kota

Her anahtarın günlük istek kotası vardır. Yanıtta X-Quota-Limit, X-Quota-Used ve X-Quota-Remaining başlıkları döner. Kota her gün UTC gece yarısı (Türkiye saatiyle 03:00) sıfırlanır.

Hata kodları

  • 401 API_KEY_REQUIREDAnahtar gönderilmedi
  • 401 API_KEY_INVALIDAnahtar geçersiz
  • 401 API_KEY_REVOKEDAnahtar iptal edildi
  • 401 API_KEY_EXPIREDAnahtarın süresi doldu
  • 403 ORIGIN_NOT_ALLOWEDiframe izin verilmeyen bir sitede
  • 400 INVALID_PARAMETEREksik ya da hatalı parametre
  • 429 QUOTA_EXCEEDEDGünlük kota doldu (retryAt alanına bakın)

iframe olayları (postMessage)

iframe, sayfanıza iki mesaj gönderir: "resize" (yükseklik — iframe kaydırma çubuğu olmadan uzar) ve "select" (seçilen marka, model, nesil ve motor). Mesajlar yalnızca sizin sitenizin kökenine gönderilir.

Sık sorulanlar

Merak edilenler

Fiyatlar da görünüyor mu?

Hayır. API ve iframe yalnızca araç verisi verir; fiyat, sipariş ya da hesap bilgisi yoktur.

iframe'i hangi sitelerde kullanabilirim?

Anahtarınız, size tanımladığımız site adreslerinde çalışır (alt alan adları dahil edilebilir). Başka bir sitede açılırsa "bu sitede kullanılamaz" uyarısı görünür.

Görünümü değiştirebilir miyim?

iframe'de açık/koyu tema, vurgu rengi ve dil (Türkçe, İngilizce, Almanca) seçilebilir. Tamamen kendi tasarımınızı istiyorsanız API'yi kullanın.

Günlük kota dolarsa ne olur?

O gün için yeni istekler reddedilir ve iframe'de "günlük sınıra ulaşıldı" mesajı görünür. Kota ertesi gün Türkiye saatiyle 03:00'te sıfırlanır; ihtiyacınıza göre artırabiliriz.

Veriler güncel mi?

iframe ve API, sitemizdeki kataloğun kendisinden beslenir. Kataloğa eklenen yeni araçlar ve düzeltmeler sizin tarafınızda da otomatik görünür.

Teknik bilgi gerekiyor mu?

iframe için hayır: verdiğimiz kodu sayfanıza yapıştırmanız yeterli. API ile kendi sisteminize bağlanmak için bir geliştirici gerekir.

Anahtarım başkasının eline geçerse?

Bize bildirin; anahtarı hemen iptal edip yenisini veririz. API anahtarını yalnızca sunucunuzda tutun, sayfa koduna koymayın.

Başlayalım

Araç veritabanını sitenize ekleyin

Kullanım şeklinizi ve tahmini trafiğinizi iletin; size uygun teklifi ve anahtarınızı hazırlayalım.

Teklif isteyin