Kako generirati ventic API ključ?

Integracija s platformom ventic zahtijeva API ključ za autentifikaciju zahtjeva. Ovi ključevi su jedinstveni za vašu organizaciju i omogućuju siguran pristup vašem katalogu proizvoda i trgovačkim uslugama.

Evo kako upravljati API ključevima:

1. Pristup upravljačkoj ploči za razvojne programere (Developer Dashboard)

Prijavite se na svoj ventic račun i idite na odjeljak Postavke > Razvojni programeri (Settings > Developers). Tamo ćete pronaći karticu „API Keys”.

2. Generiranje novog ključa

Za izradu novog ključa:

1. Kliknite gumb „Create API Key”.
2. Dajte ključu opisni naziv (npr. „Produkcija - Glavna trgovina” ili „Testiranje - Ivan Horvat”).
3. Odaberite opseg dopuštenja (Scopes). Preporučujemo da ključevima dodijelite samo potrebna dopuštenja (princip najmanjih privilegija).
4. Kliknite na „Generate”.

3. Sigurno pohranjivanje ključa

Nakon generiranja, ključ će vam biti prikazan samo jednom.

• Važno: Kopirajte ključ i pohranite ga na sigurno mjesto (npr. u upravitelj lozinki ili sigurni trezor za ključeve u vašoj infrastrukturi).
• Napomena: Iz sigurnosnih razloga ventic neće ponovno prikazati cijeli ključ nakon zatvaranja prozora.

4. Korištenje ključa u zahtjevima

Svi zahtjevi prema ventic API sučelju moraju sadržavati API ključ u HTTP zaglavlju X-API-Key.

Primjer korištenja s cURL-om:

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

5. Rotacija i brisanje ključeva

Ako sumnjate da je ključ otkriven, trebali biste ga odmah opozvati.

• Na upravljačkoj ploči odaberite ključ koji želite ukloniti i kliknite na „Revoke” (Opozovi).
• Nakon opoziva, svi zahtjevi koji koriste taj ključ bit će odbijeni.
• Generirajte novi ključ i ažurirajte svoju konfiguraciju.

Najbolje prakse za sigurnost

• Nikada ne objavljujte API ključeve u izvornom kodu (npr. na GitHubu). Koristite varijable okruženja.
• Koristite zasebne ključeve za testna i produkcijska okruženja.
• Redovito pregledavajte popis aktivnih ključeva i uklanjajte one koji se više ne koriste.

Ako trebate pomoć s integracijom, kontaktirajte naš tehnički tim na support@ventic.ai.