Kom godt i gang

Lav dit første kald til Motorbay API'et på cirka fem minutter. Du skal bruge en e-mailadresse, en terminal med curl og et abonnement eller en gratis prøveperiode.

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. Vælg et abonnement

Vælg et abonnement under Priser, og tryk Vælg abonnement. Nye kunder får 14 dages gratis prøveperiode på alle abonnementer undtagen Enterprise. Uden et aktivt abonnement eller en prøveperiode svarer API'et 402 med koden PaymentRequired.

4. Opret en API-nøgle

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_…"

5. 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 }
}

6. 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.

Hvis noget går galt

• 401 med ApiKeyMissing: headeren X-Api-Key mangler. Tjek, at variablen er sat, med echo $MOTORBAY_API_KEY.
• 401 med ApiKeyInvalid: nøglen er forkert, slettet eller udløbet. Opret en ny.
• 402 med PaymentRequired: vælg et abonnement, eller tjek, at din prøveperiode ikke er slut.
• 429 med RateLimitExceeded: du har sendt mere end 60 forespørgsler på et minut. Vent det antal sekunder, headeren Retry-After angiver.

Videre

• Godkendelse og API-nøgler
• Fejl
• API-reference med alle endpoints og felter