API & iframe

Nutzen Sie unsere Fahrzeugdatenbank auf Ihrer Website

Binden Sie die Fahrzeugauswahl und den Dyno-Bildschirm unserer Startseite mit einer Codezeile ein oder holen Sie alle Daten per API in Ihr eigenes System. Marke, Modell, Generation, Motor; Serien- und Stage-Leistung/Drehmoment, ECU- und Motordaten.

Angebot anfordern Live-Vorschau
  • 165+ Marken
  • 1.800+ Modelle
  • 3.100+ Generationen
  • 14.000+ Motoren

Zwei Wege

Fertiger Bildschirm oder Rohdaten — Sie entscheiden

Beide werden aus derselben Datenbank gespeist und liefern dieselben Daten. Der Unterschied liegt nur in der Nutzung.

Keine Programmierung nötig

iframe — fertige Fahrzeugauswahl

Die Fahrzeugauswahl und der Dyno-Bildschirm unserer Website, genau so, auf Ihrer Website. Fügen Sie einfach den Code, den wir Ihnen geben, in Ihre Seite ein.

  • Auswahl Marke → Modell → Generation → Motor
  • Stage 1 / Stage 2 Karten und Dyno-Diagramm
  • Helles/dunkles Design, Akzentfarbe und Sprache (TR / EN / DE)
  • Das gewählte Fahrzeug wird Ihrer Seite gemeldet (z. B. für Ihr Formular)
Für Entwickler

API — JSON-Rohdaten

Rufen Sie die Daten von Ihrem Server ab und nutzen Sie sie in Ihrem System mit Ihrem eigenen Design.

  • Einfache REST-Endpunkte, JSON-Antworten
  • Authentifizierung per Schlüssel (X-API-Key)
  • Feste Feldnamen — versioniert (/v1)
  • Tageskontingent und Nutzungs-Header

Live-Vorschau

Der Bildschirm, den Ihre Kunden sehen

Die Auswahl unten ist derselbe Bildschirm, der per iframe auf Ihrer Website erscheint. Wählen Sie ein Fahrzeug und probieren Sie es aus.

Auswählen—

Prüfstandskurve

Software-Stufe

Wählen Sie Ihr Fahrzeug – Stage-Werte und Leistungskurve erscheinen hier.

Software-Stufe

In der iframe-Version werden zusätzlich Motorcode, ECU/TCU, Bohrung/Hub, Verdichtung, Tuning-Methode, Stage 3 und E85 angezeigt.

Daten

Welche Daten erhalten Sie?

Ein Paket: Jeder Schlüssel erhält alle Daten. Keine Preise oder Bestellinformationen — nur Fahrzeugdaten.

  • FahrzeugbaumKategorie, Marke, Modell, Generation und Motor, jeweils mit fester ID.
  • Kraftstoff und HubraumBenzin, Diesel, Hybrid, Elektro, LPG; Hubraum (cm³).
  • BaujahreStart- und Endjahr der Generation.
  • Serienleistung und -drehmomentWerksleistung (PS) und Drehmoment (Nm).
  • Stage 1-3 und E85Leistung und Drehmoment nach der Optimierung.
  • ECU und TCUTyp des Motor- und Getriebesteuergeräts.
  • MotorcodeMotorcode des Herstellers.
  • Bohrung/Hub und VerdichtungZylinderbohrung × Hub und Verdichtungsverhältnis.
  • Tuning-MethodeWie die Software aufgespielt wird (z. B. OBD, Bench).

Preise

Klare Preise, keine versteckten Kosten

Beides sind Jahresabonnements; beim iframe kommt eine einmalige Einrichtungsgebühr hinzu. Die Daten sind in jedem Paket gleich: alle Fahrzeugdaten.

Keine Programmierung nötig

iframe

550 €/ Jahr

+ 450 € einmalige Einrichtung

  • Fertige Fahrzeugauswahl + Dyno-Bildschirm
  • Design, Akzentfarbe und Sprache einstellbar
  • Persönlicher Schlüssel und Freigabe Ihrer Website
  • Katalog-Updates inklusive
Angebot anfordern

Für Entwickler

API

1.750 €/ Jahr

Keine Einrichtungsgebühr

  • Alle Fahrzeugdaten, JSON, /v1-Endpunkte
  • Ihr eigenes Design, Ihr eigenes System
  • Tageskontingent und Nutzungsübersicht
  • Katalog-Updates inklusive
Angebot anfordern

Preise in Euro. Bei hohem Traffic legen wir Ihr Kontingent gemeinsam fest; für iframe und API zusammen sprechen Sie uns an.

Wie starte ich?

In vier Schritten auf Ihrer Website

  1. 01

    Kontakt aufnehmen

    Teilen Sie uns Ihren Bedarf (iframe oder API) und die Website-Adresse mit; wir erstellen ein Angebot nach Ihrer erwarteten Nutzung.

  2. 02

    Schlüssel erhalten

    Wir erstellen Ihren persönlichen Schlüssel, hinterlegen Ihre Website-Adresse und legen Ihr Tageskontingent fest.

  3. 03

    Einbinden

    Für das iframe fügen Sie den Code in Ihre Seite ein; für die API bindet Ihr Entwickler die Endpunkte an.

  4. 04

    Nutzen

    Wird der Katalog aktualisiert, erscheinen neue Fahrzeuge automatisch auch bei Ihnen. Ihr Kontingent kann bei Bedarf erhöht werden.

Für Entwickler

Technische Details

Ein kurzer, stabiler Vertrag: Schlüssel im Header, JSON-Antworten, Feldnamen je Version fest.

<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>

Authentifizierung

Fügen Sie jeder Anfrage den Header X-API-Key hinzu. Der API-Schlüssel (ats_live_…) ist geheim — nur auf dem Server verwenden. Der iframe-Schlüssel (ats_pk_…) funktioniert nur auf den für Sie hinterlegten Websites.

Endpunkte

  • GET /api/v1/meIhr Schlüssel, Kontingent und heutige Nutzung
  • GET /api/v1/categoriesFahrzeugkategorien
  • GET /api/v1/brands?categoryId=…Marken (nach Kategorie)
  • GET /api/v1/models?brandId=…Modelle einer Marke
  • GET /api/v1/generations?modelId=…Generationen eines Modells
  • GET /api/v1/engines?generationId=…Motoren einer Generation mit allen Daten

Kontingent

Jeder Schlüssel hat ein tägliches Anfragekontingent. Antworten enthalten die Header X-Quota-Limit, X-Quota-Used und X-Quota-Remaining. Das Kontingent wird täglich um Mitternacht UTC zurückgesetzt.

Fehlercodes

  • 401 API_KEY_REQUIREDKein Schlüssel gesendet
  • 401 API_KEY_INVALIDUngültiger Schlüssel
  • 401 API_KEY_REVOKEDSchlüssel widerrufen
  • 401 API_KEY_EXPIREDSchlüssel abgelaufen
  • 403 ORIGIN_NOT_ALLOWEDiframe auf einer nicht erlaubten Website
  • 400 INVALID_PARAMETERFehlender oder ungültiger Parameter
  • 429 QUOTA_EXCEEDEDTageskontingent aufgebraucht (siehe retryAt)

iframe-Ereignisse (postMessage)

Das iframe sendet zwei Nachrichten an Ihre Seite: „resize" (Höhe — das iframe wächst ohne Scrollbalken) und „select" (gewählte Marke, Modell, Generation und Motor). Nachrichten gehen nur an den Ursprung Ihrer Website.

FAQ

Häufige Fragen

Werden auch Preise angezeigt?

Nein. API und iframe liefern nur Fahrzeugdaten; keine Preise, Bestellungen oder Kontodaten.

Auf welchen Websites kann ich das iframe nutzen?

Ihr Schlüssel funktioniert auf den Website-Adressen, die wir für Sie hinterlegen (Subdomains möglich). Auf einer anderen Website erscheint der Hinweis „auf dieser Website nicht verwendbar".

Kann ich das Aussehen ändern?

Im iframe wählen Sie helles/dunkles Design, Akzentfarbe und Sprache (Türkisch, Englisch, Deutsch). Für ein komplett eigenes Design nutzen Sie die API.

Was passiert, wenn das Tageskontingent aufgebraucht ist?

Neue Anfragen werden für diesen Tag abgelehnt und das iframe zeigt „Tageslimit erreicht". Das Kontingent wird am nächsten Tag um Mitternacht UTC zurückgesetzt; bei Bedarf erhöhen wir es.

Sind die Daten aktuell?

iframe und API werden direkt aus dem Katalog unserer Website gespeist. Neue Fahrzeuge und Korrekturen erscheinen automatisch auch bei Ihnen.

Brauche ich technisches Wissen?

Für das iframe nicht: Fügen Sie einfach den Code in Ihre Seite ein. Für die Anbindung Ihres Systems an die API wird ein Entwickler benötigt.

Was, wenn mein Schlüssel in falsche Hände gerät?

Sagen Sie uns Bescheid; wir widerrufen ihn sofort und geben einen neuen aus. Bewahren Sie den API-Schlüssel nur auf Ihrem Server auf, nie im Seitencode.

Los geht's

Bringen Sie die Fahrzeugdatenbank auf Ihre Website

Nennen Sie uns Ihre geplante Nutzung und den erwarteten Traffic; wir erstellen ein passendes Angebot und Ihren Schlüssel.

Angebot anfordern