Kako ustvariti API kjuč ventic?

Integracija s platformo ventic zahteva API ključ za avtentikacijo zahtev. Ti ključi so edinstveni za vašo organizacijo in omogočajo varen dostop do vašega kataloga izdelkov in trgovskih storitev.

Tukaj je opisano, kako upravljati API ključe:

1. Dostop do nadzorne plošče za razvijalce (Developer Dashboard)

Prijavite se v svoj račun ventic in pojdite v razdelek Nastavitve > Razvijalci (Settings > Developers). Tam boste našli zavihek "API Keys".

2. Ustvarjanje novega ključa

Za ustvarjanje novega ključa:

1. Kliknite gumb "Create API Key".
2. Ključu dajte opisno ime (npr. "Produkcija - Glavna trgovina" ali "Testiranje - Janez Novak").
3. Izberite obseg dovoljenj (Scopes). Priporočamo, da ključem dodelite le nujna dovoljenja (načelo najmanjših privilegijev).
4. Kliknite "Generate".

3. Varno shranjevanje ključa

Ko je ključ ustvarjen, vam bo prikazan le enkrat.

• Pomembno: Kopirajte ključ in ga shranite na varno mesto (npr. v upravljalnik gesel ali varno shrambo ključev v vaši infrastrukturi).
• Opomba: Iz varnostnih razlogov ventic ne bo ponovno prikazal celotnega ključa po zaprtju okna.

4. Uporaba ključa v zahtevah

Vse zahteve na vmesnik ventic API morajo vsebovati API ključ v glavi HTTP X-API-Key.

Primer uporabe s cURL:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: vaš_api_ključ_tukaj" \
     -H "Accept: application/json"

5. Rotacija in preklic ključev

Če sumite, da je bil ključ razkrit, ga morate nemudoma preklicati.

• Na nadzorni plošči izberite ključ, ki ga želite odstraniti, in kliknite "Revoke" (Prekliči).
• Po preklicu bodo vse zahteve, ki uporabljajo ta ključ, zavrnjene.
• Ustvarite nov ključ in posodobite svojo konfiguracijo.

Najboljše prakse za varnost

• Nikoli ne objavljajte API ključev v izvorni kodi (npr. na GitHubu). Uporabljajte okoljske spremenljivke.
• Uporabljajte ločene ključe za testna in produkcijska okolja.
• Redno pregledujte seznam aktivnih ključev in odstranite tiste, ki niso več v uporabi.

Če potrebujete pomoč pri integraciji, se obrnite na našo tehnično ekipo na support@ventic.ai.