INTEGRATIONSLEITFADEN

Überprüfen Sie Fahrzeuge von Ihrem Server.

Authentifizierung

Erstellen Sie ein Konto und kopieren Sie Ihr Passwort aus „Mein Konto“. Verwenden Authorization: Bearer TU_CLAVE oder die Kopfzeile X-API-Key. Fügen Sie keine Schlüssel in URLs, öffentliches HTML oder Browser-JavaScript ein.

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

Filter und Paginierung

Parameter	Benutzen
brand / brand_id	Genaue Marke oder Kennung.
model / model_id	Teil des Namens oder der Kennung.
cc, kw, cv	Exakte Zahlenwerte.
y1, y2	Überlappung mit dem Intervall von Jahren. Verwenden Sie für ein bestimmtes Jahr beide mit demselben Wert.
limit	Zwischen 1 und 100; Standard 50.
offset	Von 0. Verwenden Sie next_offset, während has_more wahr ist.

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

Anschauliches Beispiel für ein Format. Die konkreten Ergebnisse hängen vom Katalog ab.

Filter des aktualisierten Katalogs

generation, fuel, technology, engine: Exakte Textwerte.

fuel=Diésel&technology=TDI&engine=BKD

Gleichgewicht und Grenzen

Jede 200. Antwort verbraucht eine Datenbankabfrage, auch wenn es keine Übereinstimmungen gibt. Fehler verbrauchen kein Guthaben. Das Limit pro Minute wird zwischen den Schlüsseln desselben Benutzers aufgeteilt und über die letzten 60 Sekunden überprüft.

Zuerst werden die aktuellen monatlichen Datenbankabfragen ausgegeben und dann die zusätzlich erworbenen. Die Aufladungen bleiben bei der Verlängerung des Monats erhalten. Kostenlose Pläne verlängern sich bei Nutzung oder über Cron; Zahlungspläne werden erst nach einer verifizierten Zahlung wieder aufgefüllt. Läuft die Frist ab, ist Ihr Monatsguthaben nicht mehr verfügbar.

HTTP	Bedeutung
400	Ungültige Filter oder ungültiger Jahresbereich.
401	API-Schlüssel fehlt.
402	Keine Datenbankabfragen verfügbar.
403	Inaktiver Schlüssel oder Abonnement ohne Zugriff.
429	Limit pro Minute; Wiederholen nach: 60.
500 / 503	Dienst- oder Verbindungsfehler.

Datenumfang

Ein nachgestelltes Jahr mit Null gibt an, dass das nachgestellte Jahr nicht bekannt ist, und wird beim Filtern als offener Bereich behandelt. Es beweist nicht, dass das Modell noch hergestellt wird. Invertierte Bereiche werden bis zur Überprüfung ausgeschlossen. Kraftstoff-, Karosserie- und andere Felder dürfen nicht gemeldet werden. Diese Daten garantieren nicht die Kompatibilität eines Ersatzteils: Diese Beziehung muss vom Geschäft bereitgestellt und validiert werden.