Hvordan genererer jeg en ventic API-nøgle?

Integration med ventic-platformen kræver en API-nøgle for at godkende anmodninger. Disse nøgler er unikke for din organisation og giver sikker adgang til dit produktkatalog og dine handelstjenester.

Her er, hvordan du administrerer dine API-nøgler.

1. Få adgang til Developer Dashboard

Log ind på din ventic-konto, og naviger til sektionen Indstillinger > Udviklere (Settings > Developers). Der finder du fanen "API-nøgler" (API Keys).

2. Generer en ny nøgle

For at oprette en ny nøgle:

1. Klik på knappen "Opret API-nøgle" (Create API Key).
2. Giv nøglen et beskrivende navn (f.eks. "Produktion - Hovedbutik" eller "Test - Søren Jensen").
3. Vælg tilladelsesomfang (Scopes). Vi anbefaler, at du kun giver nøgler de nødvendige tilladelser (princippet om mindste privilegium).
4. Klik på "Generer".

3. Sikker opbevaring af nøglen

Når nøglen er genereret, vises den kun for dig én gang.

• Vigtigt: Kopier nøglen, og gem den et sikkert sted (f.eks. i en password manager eller en sikker nøgleboks i din infrastruktur).
• Bemærk: Af sikkerhedsmæssige årsager viser ventic ikke den fulde nøgle igen, efter at vinduet er lukket.

4. Brug af nøglen i anmodninger

Alle anmodninger til ventic API skal indeholde API-nøglen i HTTP-headeren X-API-Key.

Eksempel på brug med cURL:

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

5. Nøglerotation og sletning

Hvis du har mistanke om, at en nøgle er blevet kompromitteret, bør du straks gøre den ugyldig.

• I instrumentbrættet skal du vælge den nøgle, du vil fjerne, og klikke på "Tilbagekald" (Revoke).
• Efter tilbagekaldelse vil enhver anmodning, der bruger den nøgle, blive afvist.
• Generer en ny nøgle, og opdater din konfiguration.

Bedste praksis for sikkerhed

• Publicer aldrig API-nøgler i kildekoden (f.eks. på GitHub). Brug miljøvariabler.
• Brug separate nøgler til test- og produktionsmiljøer.
• Gennemgå regelmæssigt listen over aktive nøgler, og fjern dem, der ikke længere er i brug.

Hvis du har brug for hjælp til integrationen, kan du kontakte vores tekniske team på support@ventic.ai.