API
Hondapedia API
Öffentliche Read-only-Endpunkte für veröffentlichte Wissensbeiträge und technische Stammdaten.
Version 1
Endpunkte
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/v1 | API-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.json | Maschinenlesbare 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. |