Bilonline Vehicle API

Bilonline Developer

Vehicle API

Sök i ett fordonslager, filtrera fordonsdata och hämta bildadresser för enskilda fordon.

Testa API Läs dokumentationen

Kom igång snabbt

Quick Start

Fyra steg för att hämta fordonsdata och bilder från Bilonline Vehicle API.

1

Skaffa en API-nyckel

API-nyckeln skapas av Bilonline och kopplas till ett organisationsnummer och ett fordonslager.

Autentisering apikey
2

Sök fordonslager

Skicka organisationsnummer och valfria filter för att hämta ett eller flera fordon.

POST /api/vehicle-inventory/search
Visa request 
{
  "orgnr": "555555-5555",
  "regnr": "ABC123"
}
3

Visa första bilden

Varje fordonsobjekt innehåller imagebaseurl. Förstabilden följer Bilonlines filnamnsstandard.

Visa JavaScript 

const regnr = vehicle.regnr
  .replace(/\s+/g, "")
  .toUpperCase();

const imageUrl =
  `${vehicle.imagebaseurl}` +
  `${regnr}/${regnr}-1004.jpg`;
4

Hämta alla bilder

Använd bildendpointen när du behöver samtliga stora bilder och thumbnails för ett fordon.

GET /api/vehicle-inventory/{registrationNumber}/images
Visa header 
X-API-Key: DIN_API_NYCKEL
Öppna API Playground Läs API-referensen

Introduktion

Bilonline Vehicle API används av externa system, webbplatser och integrationspartners för att läsa fordonsdata från ett Bilonline-lager.

API:t består av två huvudsakliga endpoints:

  • POST /api/vehicle-inventory/search för att söka och filtrera fordonsdata.
  • GET /api/vehicle-inventory/{registrationNumber}/images för att hämta bildadresser för ett fordon.
Base URL https://integrationhub.bilonline.se

Autentisering

Alla anrop kräver en API-nyckel som tilldelas av Bilonline.

API-nyckeln skickas i HTTP-headern

Alla Vehicle API-endpoints autentiseras genom att API-nyckeln skickas i HTTP-headern X-API-Key. 

X-API-Key: DIN_API_NYCKEL
API-nyckeln ska hanteras som en hemlighet och får inte publiceras i klientkod som används på publika webbplatser.
POST /api/vehicle-inventory/search

Sök fordonslager

Endpointen returnerar samtliga matchande fordonsobjekt. Filter som utelämnas används inte.

Exempel på request


{
    "orgnr": "555555-5555",
    "regnr": "ABC123",
    "marke": "Kia",
    "sold": "false",
    "antposter": 12
}

Vanliga parametrar

Parameter Typ Beskrivning
orgnr string Obligatoriskt organisationsnummer.
regnr string Filtrerar på registreringsnummer.
id integer Filtrerar på internt fordons-ID.
marke string Filtrerar på märke.
modell string Filtrerar på modell.
ano boolean/string Filtrerar på annonserade fordon. ('true' eller 'false')
sold boolean/string Filtrerar på sålda eller lagerförda fordon. ('true' eller 'false')
antposter integer Maximalt antal poster, högst 500.
GET /api/vehicle-inventory/{registrationNumber}/images

Hämta fordonsbilder

Returnerar stora bilder och thumbnails för ett registreringsnummer.

Exempel på response


{
    "registrationNumber": "ABC123",
    "count": 2,
    "images": [
        {
        "sortOrder": 1,
        "url": "https://fordonsbilder.bilonline.se/bilteamet/ABC123/ABC123-1004.jpg",
        "thumbnailUrl": "https://fordonsbilder.bilonline.se/bilteamet/ABC123/ABC123-1000.jpg"
        },
        {
        "sortOrder": 2,
        "url": "https://fordonsbilder.bilonline.se/bilteamet/ABC123/ABC123-2024.jpg",
        "thumbnailUrl": "https://fordonsbilder.bilonline.se/bilteamet/ABC123/ABC123-2020.jpg"
        }
    ]
}

Interaktivt testverktyg

API Playground

API-nyckeln används endast för det aktuella anropet och sparas inte i webbläsaren.

Live request

Din aktuella request

Uppdateras automatiskt
POST /api/vehicle-inventory/search

Headers

Body

Genereras automatiskt

Kodexempel för din request

Exemplen uppdateras när du ändrar värdena i formuläret.

Kodexemplen kan innehålla den API-nyckel du har skrivit i formuläret. Kopiera eller dela därför exemplen med försiktighet. Värdet sparas inte av sidan.

Felkoder

Status Betydelse
400 Requesten saknar obligatoriska värden.
401 API-nyckeln saknas eller är felaktig.
403 API-nyckeln saknar åtkomst till angivet organisationsnummer.
500 Ett internt fel uppstod.