← Für Händler

Händler-API

Die API richtet sich an Unternehmen, die ihre Anzeigen aus dem eigenen System verwalten möchten. Die Anzeigen verhalten sich genauso wie per Feed importierte — dieselben Felder und Regeln.

Schlüssel

Den API-Schlüssel erstellen Sie in Ihrem Firmenkonto (Konto → Firmenprofil → API und Import). Der Schlüssel wird einmal angezeigt; Sie können ihn jederzeit widerrufen oder einen neuen erstellen. Das Veröffentlichen über die API ist möglich, sobald das Unternehmen freigegeben ist.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Anfragen

{id} — die ID der Anzeige in Ihrem System (Buchstaben, Ziffern, Punkt, Bindestrich, Unterstrich, Doppelpunkt; bis zu 120 Zeichen). Anhand dieser ID wird die Anzeige aktualisiert, daher muss sie gleich bleiben.

Beispiel

curl -X PUT https://autoskelbimai.com/api/v1/listings/A-1042 \
  -H "Authorization: Bearer as_xxxxxxxx…" -H "Content-Type: application/json" \
  -d '{
    "category": "automobiliai", "make": "Volkswagen", "model": "Golf", "version": "1.4 TSI Highline",
    "year": 2017, "mileage": 98000, "price": 12900, "currency": "EUR",
    "fuel": "petrol", "gearbox": "manual", "body": "hatchback", "power_kw": 92,
    "vin": "WVWZZZAUZHW000000", "city": "Vilnius", "country": "LT",
    "description": "…", "description_lang": "lt",
    "photos": ["https://example.com/foto/1.jpg", "https://example.com/foto/2.jpg"]
  }'

Antwort: 201 — erstellt, 200 — aktualisiert oder unverändert.

{"result": "created", "id": 2381, "external_id": "A-1042", "status": "active", "url": "https://autoskelbimai.com/skelbimas/2381-volkswagen-golf-1-4-tsi-highline", …}

Entfernen: DELETE /api/v1/listings/A-1042?reason=sold

Felder

Pflicht ist nur „price“ (größer als 0). Die Kategorie ist unser Kategorie-Slug (z. B. automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); Marke und Modell als übliche Namen (werden automatisch erkannt).

id url category deal make model version title year month mileage hours price currency fuel gearbox body drive power_kw power_hp engine_cc color doors seats vin condition country city description description_lang negotiable vat phone photos fuel_city fuel_highway fuel_combined co2

Fotos — ein Array öffentlicher Bild-URLs (bis zu 30); sie werden innerhalb weniger Minuten im Hintergrund heruntergeladen. Ändert sich die Liste, werden die Fotos aktualisiert.

Feed für den automatischen Import

Dieselben Felder funktionieren in einem XML-, CSV- oder JSON-Feed, dessen Adresse Sie in Ihrem Firmenkonto angeben. Der Feed wird regelmäßig geprüft; Anzeigen, die länger als 3 Tage im Feed fehlen, werden ausgeblendet.

<listings>
  <listing>
    <id>A-1042</id><category>automobiliai</category><make>Volkswagen</make><model>Golf</model>
    <year>2017</year><mileage>98000</mileage><price>12900</price><currency>EUR</currency>
    <photos><photo>https://example.com/foto/1.jpg</photo></photos>
  </listing>
</listings>

Limits und Fehler

Bis zu 600 Anfragen pro Minute und Schlüssel. Fehler werden als JSON mit den Feldern „error“ und „message“ zurückgegeben.