Ako generovať ventic API kľúč?

API kľúč je vyžadovaný na autentizáciu požiadaviek pre integráciu s platformou ventic. Tieto kľúče sú unikátne pre vašu organizáciu a poskytujú zabezpečený prístup k vášmu produktovému katalógu a obchodným službám.

Tu je návod, ako spravovať svoj API kľúč:

1. Prístup k vývojárskemu panelu

Prihláste sa do svojho účtu ventic a prejdite do sekcie Settings > Developers. Tam nájdete záložku s názvom „API Keys“.

2. Vytvorenie nového kľúča

Ak chcete vygenerovať nový kľúč:

1. Kliknite na tlačidlo “Create API Key”.
2. Pomenujte kľúč popisným názvom (napr. „Production - Main Store“ alebo „Testovanie - Michal“).
3. Vyberte rozsah oprávnení (Scopes). Odporúčame prideľovať kľúčom iba nevyhnutné oprávnenia (princíp minimálnych oprávnení).
4. Kliknite na “Generate”.

3. Bezpečné uloženie kľúča

Po vytvorení sa vám kľúč zobrazí iba raz.

• Dôležité: Skopírujte si kľúč a uložte ho na bezpečné miesto (napr. správca hesiel alebo zabezpečené úložisko kľúčov vo vašom systéme).
• Poznámka: Z bezpečnostných dôvodov ventic po zatvorení okna znova nezobrazí celý kľúč.

4. Použitie kľúča v požiadavkách

Všetky požiadavky odosielané do rozhrania ventic API musia obsahovať API kľúč v HTTP hlavičke X-API-Key.

Príklad použitia s cURL:

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

5. Rotácia a revokácia (zneplatnenie) kľúča

Ak máte podozrenie, že váš kľúč unikol, mali by ste ho okamžite zneplatniť.

• V ovládacom paneli vyberte kľúč, ktorý chcete odstrániť, a kliknite na “Revoke” (Zneplatniť).
• Po zneplatnení bude akákoľvek požiadavka používajúca tento kľúč odmietnutá.
• Vygenerujte nový kľúč a aktualizujte konfiguráciu svojho systému.

Odporúčané postupy pre bezpečnosť

• Nikdy nepublikujte API kľúče v zdrojovom kóde (napr. na GitHub-e). Používajte premenné prostredia (environment variables).
• Používajte oddelené kľúče pre testovacie (testing) a produkčné (production) prostredie.
• Pravidelne kontrolujte zoznam aktívnych kľúčov a odstraňujte tie, ktoré sa už nepoužívajú.

Ak potrebujete pomoc s integráciou, kontaktujte náš technický tím na support@ventic.ai.