REST API Pro

Voller Direkt-Zugriff auf das Bewertungs-Backend, das schon das autofokus24.de-Portal antreibt. Saubere Endpunkte für die Modellpalette und HSN/TSN-basierte Wertberechnung.

API-Schlüssel anfragen

Endpunkte im Überblick

REST über HTTPS, JSON-Responses, HTTP Basic Auth pro Mandant. Versionierter Pfad /api/v2/.

GET /api/v2/brands
GET /api/v2/brands/{id}/models?year=YYYY&month=MM
GET /api/v2/models/{id}/series?year=YYYY&month=MM
GET /api/v2/series/{id}/bodies?year=YYYY&month=MM
GET /api/v2/series/{id}/bodies/{id}/engines?year=YYYY&month=MM
GET /api/v2/series/{id}/bodies/{id}/engines/{id}/editions
GET /api/v2/calculate/{hsn}/{tsn}?year=YYYY&month=MM&mileage=NNNNN

Antwort-Beispiel

/api/v2/calculate/0588/BID?year=2018&month=6&mileage=80000 liefert pro passender Variante einen Datensatz wie diesen (gekürzt):

[{
  "brand": "Audi", "model": "A3",
  "series": "Modell ab 2016 (8V Facelift)",
  "body": "LIMOUSINE", "doors": 4,
  "kw": 110, "fuel": "DIESEL", "cubic_capacity": 1968,
  "production_start": 2016,
  "buying_price":  12634,
  "selling_price": 16268,
  "estimated_standing_time": 71,
  "sales_probability":      0.81,
  "guarantee": "OGEW",
  "equipment_by_date":   ["...", "..."],
  "equipment_by_engine": ["...", "..."]
}]

Fairer Umgang mit Limits

Pro Mandant ein eigener User in serviceusers2, pro Endpunkt ein eigener Counter (u1..u6). Soft-Limits gehen an Sie als Erinnerung, Hard-Limits werden mit HTTP 450 angezeigt.

Pro Endpunkt-Stufe

u1=brands, u2=models, u3=series, u4=bodies, u5=engines, u6=editions. So zahlen Sie nicht für 1000 Markenabfragen, wenn Sie die Modellpalette einmal pro Tag cachen können.

Bewertungs-Counter separat

/calculate wird in serviceusers gezählt — meist die teuerste Stufe, mit konfigurierbarer Obergrenze (maxUsage).

Anbindung Schritt für Schritt

Sie schreiben uns kurz, was Sie vorhaben.
Wir legen Ihnen einen API-User mit angemessenen Limits an.
Sie bekommen Login-Daten + die volle Endpunkt-Doku.
Test-Calls per curl oder Ihrem Lieblings-Tool.
Bei Fragen: einer von uns ist im Slack/Mail erreichbar.

Schritt 1 starten