Godkendelse og API-nøgler

Alle forespørgsler til Motorbay API'et kræver en API-nøgle. Der er ikke andet at sætte op: ingen OAuth, ingen tokens at forny.

Send nøglen i én header

curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
  "https://api.motorbay.app/v1/dataset"

Nøglen skal i headeren X-Api-Key og ingen andre steder. Nøgler accepteres ikke i query-strengen, hvor de ender i logfiler og browserhistorik. En forespørgsel med nøglen i query-strengen og uden headeren får 401 med koden ApiKeyMissing.

Sådan ser en nøgle ud

• Produktionsnøgler begynder med mbk_live_. Nøgler fra et testmiljø begynder med mbk_test_.
• Efter præfikset kommer 43 tegn: bogstaver, tal, - og _.
• I eksempler skriver vi mbk_test_… eller $MOTORBAY_API_KEY. Indsæt aldrig en rigtig nøgle i en issue, en supportmail eller et skærmbillede.

En nøgle fra det ene miljø virker ikke i det andet.

Opret en nøgle

1. Bekræft din e-mail. Du kan ikke oprette en nøgle, før du har gjort det.
2. Vælg et abonnement, eller start den gratis prøveperiode under Priser.
3. På oversigten vælger du Opret nøgle. Giv den et navn, og en udløbsdato, hvis du vil.

Nøglen vises én gang, når du opretter den. Vi gemmer kun en hash af den, så vi kan ikke vise den igen eller gendanne den. Hvis du mister en nøgle, så opret en ny, og slet den gamle.

Slet en nøgle, eller lad den udløbe

Slet en nøgle på oversigten, når du ikke længere har brug for den, eller hvis den kan være lækket. Forespørgsler med en slettet nøgle afvises derefter med 401 og koden ApiKeyInvalid. En nøgle, hvis udløbsdato er passeret, afvises på samme måde.

Sådan skifter du en nøgle uden nedetid: opret en ny nøgle, tag den i brug, og slet så den gamle.

Hold nøglerne på din server

Kald API'et fra din server, ikke fra en browser eller en mobilapp. Ethvert script på en webside kan læse en nøgle, siden har, og alle kan trække en nøgle ud af en app.

Hvad fejlene betyder

Se Fejl for hele listen.