Jak generovat ventic API klíč?

API klíč je vyžadován k autentizaci požadavků pro integraci s platformou ventic. Tyto klíče jsou unikátní pro vaši organizaci a poskytují zabezpečený přístup k vašemu produktovému katalogu a obchodním službám.

Zde je návod, jak spravovat svůj API klíč:

1. Přístup k vývojářskému panelu

Přihlaste se ke svému účtu ventic a přejděte do sekce Settings > Developers. Tam najdete záložku s názvem „API Keys“.

2. Vytvoření nového klíče

Chcete-li vygenerovat nový klíč:

1. Klikněte na tlačítko “Create API Key”.
2. Pojmenujte klíč popisným názvem (např. „Production - Main Store“ nebo „Testování - Jan“).
3. Vyberte rozsah oprávnění (Scopes). Doporučujeme přidělovat klíčům pouze nezbytná oprávnění (princip minimálních oprávnění).
4. Klikněte na “Generate”.

3. Bezpečné uložení klíče

Po vytvoření se vám klíč zobrazí pouze jednou.

• Důležité: Zkopírujte si klíč a uložte jej na bezpečné místo (např. správce hesel nebo zabezpečené úložiště klíčů ve vašem systému).
• Poznámka: Z bezpečnostních důvodů ventic po zavření okna znovu nezobrazí celý klíč.

4. Použití klíče v požadavcích

Všechny požadavky odesílané do rozhraní ventic API musí obsahovat API klíč v HTTP hlavičce X-API-Key.

Příklad použití s cURL:

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

5. Rotace a revokace (zneplatnění) klíče

Pokud máte podezření, že váš klíč unikl, měli byste jej okamžitě zneplatnit.

• V ovládacím panelu vyberte klíč, který chcete odstranit, a klikněte na “Revoke” (Zneplatnit).
• Po zneplatnění bude jakýkoli požadavek používající tento klíč odmítnut.
• Vygenerujte nový klíč a aktualizujte konfiguraci svého systému.

Doporučené postupy pro bezpečnost

• Nikdy nepublikujte API klíče ve zdrojovém kódu (např. na GitHubu). Používejte proměnné prostředí (environment variables).
• Používejte oddělené klíče pro testovací (testing) a produkční (production) prostředí.
• Pravidelně kontrolujte seznam aktivních klíčů a odstraňujte ty, které se již nepoužívají.

Pokud potřebujete pomoc s integrací, kontaktujte náš technický tým na support@ventic.ai.