Hvordan genererer jeg en ventic API-nøkkel?

Integrasjon med ventic-plattformen krever en API-nøkkel for å autentisere forespørsler. Disse nøklene er unike for din organisasjon og gir sikker tilgang til produktkatalogen og handelstjenestene dine.

Her er hvordan du administrerer API-nøklene dine.

1. Få tilgang til Developer Dashboard

Logg inn på ventic-kontoen din og naviger til seksjonen Innstillinger > Utviklere (Settings > Developers). Der finner du fanen "API-nøkler" (API Keys).

2. Generer en ny nøkkel

For å opprette en ny nøkkel:

1. Klikk på knappen "Opprett API-nøkkel" (Create API Key).
2. Gi nøkkelen et beskrivende navn (f.eks. "Produksjon - Hovedbutikk" eller "Test - Ola Nordmann").
3. Velg tilgangsnivåer (Scopes). Vi anbefaler at du bare gir nøkler de nødvendige tillatelsene (prinsippet om minste privilegium).
4. Klikk på "Generer".

3. Sikker lagring av nøkkelen

Når nøkkelen er generert, vises den for deg kun én gang.

• Viktig: Kopier nøkkelen og lagre den på et sikkert sted (f.eks. i en passordbehandler eller et sikkert hvelv i infrastrukturen din).
• Merk: Av sikkerhetsgrunner viser ikke ventic den fullstendige nøkkelen igjen etter at vinduet er lukket.

4. Bruk av nøkkelen i forespørsler

Alle forespørsler til ventic API skal inneholde API-nøkkelen i HTTP-headeren X-API-Key.

Eksempel på bruk med cURL:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: din_api_nøkkel_her" \
     -H "Accept: application/json"

5. Nøkkelrotasjon og sletting

Hvis du mistenker at en nøkkel er på avveie, bør du umiddelbart deaktivere den.

• I dashbordet velger du nøkkelen du vil fjerne og klikker på "Tilbakekall" (Revoke).
• Etter tilbakekalling vil alle forespørsler som bruker den nøkkelen bli avvist.
• Generer en ny nøkkel og oppdater konfigurasjonen din.

Beste praksis for sikkerhet

• Publiser aldri API-nøkler i kildekoden (f.eks. på GitHub). Bruk miljøvariabler.
• Bruk separate nøkler for test- og produksjonsmiljøer.
• Gå regelmessig gjennom listen over aktive nøkler og fjern de som ikke lenger er i bruk.

Hvis du trenger hjelp med integrasjonen, kontakt vårt tekniske team på support@ventic.ai.