Hur genererar jag en ventic API-nyckel?
Integration med ventic-plattformen kräver en API-nyckel för att autentisera förfrågningar. Dessa nycklar är unika för din organisation och ger säker åtkomst till din produktkatalog och dina handelstjänster.
Här är hur du hanterar dina API-nycklar.
1. Få åtkomst till Developer Dashboard
Logga in på ditt ventic-konto och navigera till sektionen Inställningar > Utvecklare (Settings > Developers). Där hittar du fliken "API-nycklar" (API Keys).
2. Generera en ny nyckel
För att skapa en ny nyckel:
- Klicka på knappen "Skapa API-nyckel" (Create API Key).
- Ge nyckeln ett beskrivande namn (t.ex. "Produktion - Huvudbutik" eller "Test - Anders Andersson").
- Välj behörighetsomfång (Scopes). Vi rekommenderar att du bara ger nycklar de nödvändiga behörigheterna (principen om minsta privilegium).
- Klicka på "Generera".
3. Säker lagring av nyckeln
När nyckeln har genererats visas den för dig endast en gång.
- Viktigt: Kopiera nyckeln och spara den på en säker plats (t.ex. i en lösenordshanterare eller ett säkert nyckelvalv i din infrastruktur).
- Observera: Av säkerhetsskäl visar ventic inte den fullständiga nyckeln igen efter att fönstret stängts.
4. Användning av nyckeln i förfrågningar
Alla förfrågningar till ventic API ska innehålla API-nyckeln i HTTP-huvudet X-API-Key.
Exempel på användning med cURL:
curl -X GET "https://api.ventic.ai/v1/products" \
-H "X-API-Key: din_api_nyckel_här" \
-H "Accept: application/json"
5. Nyckelrotation och borttagning
Om du misstänker att en nyckel har röjts bör du omedelbart ogiltigförklara den.
- I kontrollpanelen väljer du den nyckel du vill ta bort och klickar på "Återkalla" (Revoke).
- Efter återkallelse kommer alla förfrågningar som använder den nyckeln att avvisas.
- Generera en ny nyckel och uppdatera din konfiguration.
Bästa praxis för säkerhet
- Publicera aldrig API-nycklar i källkoden (t.ex. på GitHub). Använd miljövariabler.
- Använd separata nycklar för test- och produktionsmiljöer.
- Granska regelbundet listan över aktiva nycklar och ta bort de som inte längre används.
Om du behöver hjälp med integrationen, kontakta vårt tekniska team på support@ventic.ai.