Vejledninger: Kom godt i gang
Kom godt i gang
Lav dit første kald til Motorbay API'et på cirka fem minutter. Du skal bruge en e-mailadresse og en terminal med curl. Free-abonnementet kræver intet kort.
1. Opret en konto
Åbn Motorbay Console, og opret en konto under fanen Opret konto. Brug en e-mailadresse, du kan læse nu.
2. Bekræft din e-mail
Vi sender dig et link. Åbn det for at bekræfte din e-mail. Du kan ikke oprette API-nøgler, før du har gjort det. Indtil da skriver konsollen "Bekræft din e-mail for at oprette API-nøgler."
3. Opret en API-nøgle
Hver ny konto starter på Free-abonnementet, uden kort og uden noget at vælge først. Priser viser, hvor mange forespørgsler Free har inkluderet hver måned.
På oversigten vælger du Opret nøgle. Giv den et navn efter, hvor du vil bruge den, fx "Produktionsserver".
Nøglen vises én gang. Kopiér den nu, og gem den et sikkert sted. Vi gemmer kun en hash, så en mistet nøgle kan ikke gendannes. Læg den i en miljøvariabel:
export MOTORBAY_API_KEY="mbk_live_…"4. Lav dit første kald
Send nøglen i headeren X-Api-Key. Dette kald viser de første tre køretøjsarter:
curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
"https://api.motorbay.app/v1/kinds?pageSize=3"Et 200-svar ser sådan ud:
{
"data": [
{ "id": "1", "name": "Personbil", "originalName": "Personbil" },
{ "id": "2", "name": "Stor personbil", "originalName": "Stor personbil" },
{ "id": "3", "name": "Varebil", "originalName": "Varebil" }
],
"metadata": { "page": 1, "pageSize": 3, "totalCount": 15, "totalPages": 5 }
}5. Slå et køretøj op
Slå et køretøj op på registreringsnummer:
curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
"https://api.motorbay.app/v1/vehicles/plate/AB12345"Du får køretøjet som JSON, eller 404 med koden VehicleNotFound, hvis intet køretøj har det registreringsnummer. AB12345 er et eksempel. Brug en nummerplade, du kender.
Tilføj include for at få dele af køretøjet med i samme svar, stadig som én forespørgsel:
curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
"https://api.motorbay.app/v1/vehicles/plate/AB12345?include=engine,inspection"Svaret får engine og inspection, de samme objekter som /v1/vehicles/{id}/engine og /v1/vehicles/{id}/inspection. include=all tilføjer alle dele. Er du ikke sikker på, om du har en nummerplade eller et stelnummer? /v1/vehicles/lookup/{plateOrVin} tager begge.
Brug Postman i stedet
Hent Postman-samlingen, og importér den i Postman med Import. Den har alle endpoints og er bygget ud fra det samme OpenAPI-dokument som API-referencen. Åbn fanen Variables på samlingen, og indsæt din nøgle i apiKey. Samlingen sender den i headeren X-Api-Key ved hvert kald. apiKey er tom, når du henter samlingen, så del ikke en eksporteret kopi, efter du har udfyldt den.
Hvis noget går galt
401medApiKeyMissing: headerenX-Api-Keymangler. Tjek, at variablen er sat, medecho $MOTORBAY_API_KEY.401medApiKeyInvalid: nøglen er forkert, tilbagekaldt eller udløbet. Opret en ny.402medPaymentRequired: dit betalte abonnement er i en tilstand, vi ikke kan bekræfte. Åbn betalingsportalen fra din kontoside, eller skriv til support.429medQuotaExceeded: de gratis forespørgsler for denne måned er brugt. De kommer tilbage den 1., eller du kan opgradere under Priser.429medRateLimitExceeded: du har sendt mere end 60 forespørgsler på et minut. Vent det antal sekunder, headerenRetry-Afterangiver.
Videre
- Godkendelse og API-nøgler
- Fejl
- API-reference med alle endpoints og felter
Fandt du ikke svaret? Skriv til support@motorbay.app.