Katalog: Marken und Modelle der API
Der Katalog nennt alle Marken und Modelle, die die API bewerten kann. Er eignet sich für Auswahllisten in Ihrer Software und folgt dem Schweizer Markt: Was hier oft inseriert ist, steht im Katalog.
curl https://prisradar.ch/api/v1/catalog/makes/audi/models \ -H "Authorization: Bearer $PRISRADAR_KEY"
{
"make": {
"id": "AUDI",
"name": "Audi"
},
"models": [
{
"id": "A3",
"name": "A3"
},
{
"id": "Q5",
"name": "Q5"
},
{
"id": "Q5 SPORTBACK",
"name": "Q5 Sportback"
}
]
}Wie bekomme ich alle Marken?
Mit GET /v1/catalog/makes. Die Antwort ist eine Liste mit id und name jeder Marke. name ist die Schreibweise für die Anzeige, id die des Katalogs. Für eine Bewertung dürfen Sie beides schicken oder eine eigene Schreibweise; die API findet die Marke trotzdem.
GEThttps://prisradar.ch/api/v1/catalog/makes
Wie bekomme ich die Modelle einer Marke?
Mit GET /v1/catalog/makes/{make}/models, zum Beispiel …/makes/audi/models. Die Antwort nennt die Marke und ihre Modelle, jedes mit id und name. Kennt der Katalog die Marke nicht, kommt 404 unknown_make mit Vorschlägen für ähnliche Namen. Beides können Sie direkt für eine Bewertung verwenden.
GEThttps://prisradar.ch/api/v1/catalog/makes/{make}/models
Wie aktuell ist der Katalog?
Der Katalog folgt dem Markt und wird regelmässig neu berechnet. Kommt ein neues Modell oft genug in Schweizer Inseraten vor, erscheint es im Katalog; verschwindet ein seltenes Modell aus dem Markt, kann es wegfallen. Laden Sie die Listen deshalb regelmässig neu, statt sie fest zu speichern.
Nicht gefunden, was Sie suchen?Schreiben Sie an info@prisradar.ch oder über das Kontaktformular.