Schnittstellen

Für Garagen, Händlersysteme (DMS) und Partner. Alle Antworten als JSON, UTF-8.

1. Fahrzeuge importieren (Push)

Legt Inserate an oder aktualisiert sie. Zuordnung über external_id (eure Fahrzeugnummer). Max. 200 Fahrzeuge pro Aufruf.

POST https://www.autobuehne.ch/api/import
Content-Type: application/json
x-api-key: ab_…            ← im Konto unter «Schnittstelle» erzeugen

{
  "ki_bilder": true,              // erstes Bild mit KI freistellen (optional)
  "deaktiviere_fehlende": true,   // nicht mehr gelieferte Fahrzeuge deaktivieren (Vollsync, optional)
  "fahrzeuge": [
    {
      "external_id": "F-2031",
      "marke": "BMW", "modell": "320d Touring",
      "erstzulassung": "03.2021", "kilometer": 58200,
      "treibstoff": "Diesel", "getriebe": "Automat", "leistung_ps": 190,
      "preis_chf": 32900, "farbe": "Schwarz", "kanton": "BE", "mfk": "05.2026",
      "ausstattung": "AHK, LED, Navi", "beschreibung": "…",
      "zustand": { "unfallfrei": "ja", "serviceheft": "ja", "vorbesitzer": "1" },
      "bilder": ["https://…/1.jpg", "https://…/2.jpg"]
    }
  ]
}

→ { "ok": true, "angelegt": 1, "aktualisiert": 0, "uebersprungen": 0, "fehler": [], "limit": 15, "plan": "starter" }

Pflicht: marke, modell, preis_chf. Bilder werden von den angegebenen URLs geladen (max. 8). Das Inserat-Limit deines Plans gilt auch hier.

2. CSV-Import (ohne Programmierung)

Im Konto unter «Import» eine CSV/Excel-Exportdatei hochladen — z.B. aus dem AutoScout24-Händlercockpit oder deinem Händlersystem. Spalten werden automatisch erkannt (Marke, Modell, Preis, km, Erstzulassung, Treibstoff, Getriebe, PS/kW, Farbe, Bilder-URLs …) und können vor dem Import kontrolliert werden.

3. Inserate abrufen (Feed)

GET https://www.autobuehne.ch/api/feed
GET https://www.autobuehne.ch/api/feed?kanton=BE&marke=BMW&anbieter=haendler

→ { "quelle": "autobuehne.ch", "anzahl": 42, "inserate": [ { "id", "url", "marke", "modell", "preis_chf", "kanton", "bilder": [...], ... } ] }

Öffentlich, ohne Key, 5 Minuten Cache. Für Partner, Aggregatoren und eigene Apps.

DMS-Anbieter?

Ihr wollt Autobühne als Zielplattform in euer System aufnehmen? Wir unterstützen euch bei der Anbindung und richten Testkonten ein: autobuehne@gmail.com