Version 1

Endpunkte

OpenAPI JSON
Methode Pfad Beschreibung
GET/api/v1API-Index mit Links.
GET/api/v1/articles?q=&type=&category=&tag=&author=&model=&engine=Veröffentlichte Wissensbeiträge mit optionalen Filtern.
GET/api/v1/articles/{slug}Ein veröffentlichter Beitrag inklusive Inhalt.
GET/api/v1/categories?q=Wissenskategorien für Artikelfilter und Navigation.
GET/api/v1/tags?q=&type=Artikel-Tags mit optionalen Filtern.
GET/api/v1/models?q=&model=&engine=&year=Fahrzeugmodelle aus der technischen Datenbank.
GET/api/v1/models/{slug}Modelldetail inklusive Motorverknüpfungen.
GET/api/v1/engines?q=&engine=&model=&year=Motoren aus der technischen Datenbank.
GET/api/v1/engines/{slug}Motordetail inklusive Modellverknüpfungen.
GET/api/v1/wheels?q=&model=&bolt=&diameter=&width=&original=&status=&year=Felgendaten aus der technischen Datenbank.
GET/api/v1/wheels/{slug}Felgendetail inklusive Fahrzeug-Fitments.
GET/api/v1/transmissions?q=&engine=&type=&original=&status=&year=Getriebedaten aus der technischen Datenbank.
GET/api/v1/transmissions/{slug}Getriebedetail inklusive Motor-Fitments.
GET/api/v1/compatibility?q=&model=&engine=&status=&category=&year=Kompatibilitätseinträge mit optionalen Filtern.
GET/api/v1/compatibility/{id}Kompatibilitätsdetail inklusive Voraussetzungen und Hinweise.
GET/api/v1/openapi.jsonMaschinenlesbare OpenAPI-Beschreibung.
OPTIONS/api/v1/*CORS-Preflight für externe Read-only-Nutzung.

Antworten

Schemas und Filter

Die vollständigen Response-Schemas, Beispielwerte und erlaubten Filterwerte stehen in der maschinenlesbaren OpenAPI-Beschreibung. Listen-Endpunkte akzeptieren `limit` von 1 bis 100 sowie `offset` ab 0 und liefern `meta.limit`, `meta.offset`, `meta.count`, `meta.total` sowie `meta.hasMore` zurück. Artikellisten lassen sich zusätzlich über `q`, `type`, `category`, `tag`, `author`, `model` und `engine` filtern; `/api/v1/categories` liefert die passenden Kategorie-IDs, `/api/v1/tags` die verwendbaren Schlagworte. Kategorie- und Taglisten akzeptieren `q`; Taglisten zusätzlich den optionalen Filter `type`. Modell- und Motorlisten lassen sich zusätzlich über `q` und die jeweils andere technische Ebene (`model`/`engine`) sowie `year` filtern. Felgenlisten lassen sich zusätzlich über `q`, `model`, `bolt`, `diameter`, `width`, `original`, `status` und `year` filtern; Getriebelisten über `q`, `engine`, `type`, `original`, `status` und `year`. Kompatibilitätslisten akzeptieren `q`, `model`, `engine`, `status`, `category` und `year`. `original` verwendet `1` für Originalverbau und `0` für Kompatibilitäts- bzw. Nachrüstdaten. `status` akzeptiert `compatible`, `conditional`, `incompatible` und `unknown`. `year` ist ein numerischer Baujahrfilter. `links.self`, `links.next` und `links.prev` verweisen auf die aktuelle, nächste und vorherige Listenseite, sofern vorhanden. API-Antworten erlauben Cross-Origin-Zugriffe für GET und OPTIONS. `X-API-Version` nennt die ausgelieferte API-Version; der `Link`-Header mit `rel="describedby"` verweist auf die OpenAPI-Beschreibung. JSON-Antworten liefern `ETag` und `Last-Modified`; Clients können mit `If-None-Match` bedingte GET-Anfragen stellen und erhalten bei unverändertem Inhalt HTTP 304. Fehlerantworten nutzen ein einheitliches JSON-Objekt mit `error.status`, `error.title` und `error.detail`. API-Anfragen sind rate-limitiert; bei Überschreitung wird HTTP 429 mit `Retry-After` zurückgegeben.

Community

Schreibende Funktionen

Lesezeichen, Hilfreich-Bewertungen, Kommentare und Korrekturhinweise sind aktuell bewusst keine öffentlichen API-Schreib-Endpunkte. Diese Funktionen laufen über die normale Weboberfläche, benötigen eine Anmeldung und verwenden CSRF-geschützte Formulare.

Funktion Web-Route Hinweis
Lesezeichen POST /wissen/{slug}/lesezeichen Nur für angemeldete Nutzer; Toggle für veröffentlichte Artikel.
Hilfreich-Bewertung POST /wissen/{slug}/hilfreich Einmal pro Nutzer und Artikel; rate-limitiert.
Korrekturhinweis GET|POST /korrektur/{targetType}/{id} Für Artikel und technische Stammdaten; optionale Quellenangaben möglich.
Eigene Übersichten GET /profil/lesezeichen, GET /profil/korrekturen Private Listen des angemeldeten Nutzers.