Xevato›Wheels API

API-dokumentation · Wheels

Hjulmått & däckdata via
registreringsnummer

Xevato Wheels API returnerar fordonsdata, kompletta hjuluppsättningar och bromsinformation via ett enda nordiskt registreringsnummer – på under en sekund. Inklusive vilket hjul fordonet faktiskt är registrerat med.

Testa live demo Swagger-dokumentation → 
// Endpoint: fordonsdata + hjuluppsättningar via registreringsnummer
POST https://api.xevato.se/wheels/regno/ABC123/SE/
Authorization: Bearer {token}

// Svar (förenklat)
{
  "vehicleData": {
    "Maker": "MERCEDES-BENZ", "Model_fullName": "C-CLASS T-MODEL (S206)",
    "HP": 313, "KW": 230, "Fuel": "Petrol/Electric",
    "Drive_system": "Bakhjulsdrift", "vehicle_id": 146620
  },
  "wheels": {
    "mounting": { "pattern": "5x112", "center_disc": "66.6", "torque": "115 Nm", "thread": "14x1.5" },
    "sets": [{
      "registered_with": true,  // ★ detta sitter på bilen just nu
      "oe": true, "staggered": true,
      "front": { "rim": { "diameter": 18, "width": 7.5, "et": 40 }, "tire": { "width": 225, "ratio": 45, "diameter": 18, "load_index": 95, "speed_index": "Y" } },
      "rear":  { "rim": { "diameter": 18, "width": 9,   "et": 58 }, "tire": { "width": 255, "ratio": 40, "diameter": 18, "load_index": 99, "speed_index": "Y" } }
    }]
  },
  "tpms": true,  // fordonet har däcktrycksövervakning
  "brakes": { "rotor": { "front": { "type": "disc", "discs": [{"diameter_mm": "330", "thickness_mm": "24"}] } } }
}

Vad är Xevato Wheels API?

Wheels API är Xevatos kärnprodukt – ett REST API som tar ett nordiskt registreringsnummer och returnerar allt en däckverkstad eller däckbutik behöver veta om fordonets hjul. Istället för att leta i kataloger eller fråga kunden får verkstadspersonalen rätt data direkt – varje gång.

Det som gör Xevato unikt i Norden är fältet registered_with. Det markerar vilken hjuluppsättning fordonet faktiskt är registrerat med – inte bara vilka dimensioner som är godkända rent tekniskt. Det är en distinktion som sparar tid och eliminerar gissningar.

★ Registrerad uppsättning
registered_with: true
Vad fordonet faktiskt har på sig just nu. Xevatos unika USP – ingen annan aktör i Norden ger denna information.
OE – Original Equipment
oe: true
Fabriksuppsättning. Oberoende av registered_with – ett fordon kan vara registrerat med en aftermarket-uppsättning.
Staggered
staggered: true
Fram och bak har olika dimensioner. Rear-objektet är tomt när staggered är false.

Endpoints

Via registreringsnummer (rekommenderat)

Huvudendpointen – returnerar fordonsdata och samtliga hjuluppsättningar inklusive registered_with i ett enda anrop.

MetodEndpoint
POST/wheels/regno/{regno}/{country}/

Via vehicle_id

Om du redan har ett vehicle_id från ett tidigare anrop mot /regno/ eller modellväljaren kan du hämta hjuldata direkt utan att gå via registreringsnummer. Observera att registered_with inte returneras via denna endpoint.

MetodEndpoint
GET/wheels/{vehicle_id}/
Nordisk täckning: Båda endpoints stödjer registreringsnummer från Sverige (SE), Norge (NO), Danmark (DK) och Finland (FI). Ange alltid landskoden med två bokstäver, t.ex. SE.

Svarsstruktur

Montering – wheels.mounting

FältExempelBeskrivning
pattern5x112Bultkrets
center_disc66.6Navhålsdiameter i mm
thread14x1.5Gängdimension
thread_typeMetricGängtyp
typeBoltBult eller mutter
torque115 NmÅtdragningsmoment

Hjuluppsättningar – wheels.sets[]

FältTypBeskrivning
registered_withbooleanSant om fordonet är registrerat med denna uppsättning
oebooleanSant om detta är OE – originalmonterat från fabrik
staggeredbooleanSant om fram och bak har olika dimensioner
front.rim.diameterintegerFälgdiameter i tum, t.ex. 18
front.rim.widthfloatFälgbredd i tum, t.ex. 7.5
front.rim.etfloatInpress (ET-värde), t.ex. 40
front.tire.widthintegerDäckbredd i mm, t.ex. 225
front.tire.ratiointegerDäckprofil, t.ex. 45
front.tire.load_indexintegerBärförmågeindex, t.ex. 95
front.tire.speed_indexstringHastighetsindex, t.ex. Y
rearobject / []Bakaxelns uppsättning. Tom array när staggered är false.
front.rim_and_tireobjectKombinerat objekt med alla rim- och tire-värden samlat

Övriga svarsobjekt

FältBeskrivning
tpmsBoolean – sant om fordonet har däcktrycksövervakning (TPMS)
brakes.rotor.front / rearBromsskivdata: typ (disc/drum), diameter, tjocklek, mintjocklek, bromsbelägg och ok-märke
notificationVarningsobjekt – populeras om systemet inte kan avgöra registrerad hjuluppsättning. Innehåller de dimensioner som registrerats på fordonet.
vehicleData.vehicle_idXevatos interna ID – används för vidare anrop mot /parts/ och /wheels/{vehicle_id}/

Felhantering & notification

Om systemet inte kan avgöra vilken hjuluppsättning fordonet är registrerat med returneras ett notification-objekt i svaret. Det innehåller de däck- och fälgdimensioner som faktiskt registrerats på fordonet, uppdelat på fram och bak. Bygg alltid logik för att hantera detta fall i din integration.

notification.description
"System can not determine installed wheels"
Textsträng som beskriver varför matchningen är osäker.
notification.value
tyre_dimension_front/rear · rim_dimension_front/rear
Registrerade mått för däck och fälg per axel – visa dessa för användaren.

Typiska användningsfall

Däckverkstad & däckbutik

Kunden kör in – personalen slår regnumret och ser direkt vilka däck och fälgar som sitter på bilen, vilka dimensioner som är godkända, och kan matcha mot lagret utan att behöva fråga kunden eller leta i kataloger manuellt.

E-handel med däck och fälg

Integrera Wheels API i din webbshop. Kunden anger sitt registreringsnummer och får direkt upp de exakta dimensioner som passar – filtrerat och sorterat med den registrerade uppsättningen högst upp.

Verkstadssystem & DMS

Bygg in Wheels API som ett komplement i ditt befintliga system. Svaret innehåller även bromsinformation och TPMS-status, vilket gör det möjligt att förbereda hela serviceordern i ett enda anrop.

Redo att integrera?

Testa Wheels API direkt i webbläsaren – inga inloggningsuppgifter krävs för demo-uppslaget.

Prova live demo Kontakta oss Swagger Docs →