Jak wygenerować klucz API ventic?
Integracja z platformą ventic wymaga klucza API do uwierzytelniania żądań. Klucze te są unikalne dla Twojej organizacji i zapewniają bezpieczny dostęp do Twojego katalogu produktów i usług handlowych.
Oto jak zarządzać swoimi kluczami API.
1. Dostęp do panelu programisty
Zaloguj się do swojego konta ventic i przejdź do sekcji Ustawienia > Programiści (Settings > Developers). Znajdziesz tam zakładkę "Klucze API" (API Keys).
2. Generowanie nowego klucza
Aby utworzyć nowy klucz:
- Kliknij przycisk "Utwórz klucz API" (Create API Key).
- Nadaj kluczowi opisową nazwę (np. "Produkcja - Sklep Główny" lub "Testowanie - Jan Kowalski").
- Wybierz zakres uprawnień (Scopes). Zalecamy nadawanie kluczom tylko niezbędnych uprawnień (zasada najmniejszych uprawnień).
- Kliknij "Generuj".
3. Bezpieczne przechowywanie klucza
Po wygenerowaniu klucza zobaczysz go tylko raz.
- Ważne: Skopiuj klucz i zapisz go w bezpiecznym miejscu (np. w menedżerze haseł lub bezpiecznym magazynie kluczy w Twojej infrastrukturze).
- Uwaga: Ze względów bezpieczeństwa ventic nie wyświetla ponownie pełnego klucza po zamknięciu okna.
4. Użycie klucza w żądaniach
Wszystkie żądania do API ventic powinny zawierać klucz API w nagłówku HTTP X-API-Key.
Przykład użycia w cURL:
curl -X GET "https://api.ventic.ai/v1/products" \
-H "X-API-Key: twój_klucz_api_tutaj" \
-H "Accept: application/json"
5. Rotacja i usuwanie kluczy
Jeśli podejrzewasz, że klucz został ujawniony, powinieneś go natychmiast unieważnić.
- W panelu wybierz klucz, który chcesz usunąć, i kliknij "Unieważnij" (Revoke).
- Po unieważnieniu wszelkie żądania korzystające z tego klucza zostaną odrzucone.
- Wygeneruj nowy klucz i zaktualizuj swoją konfigurację.
Najlepsze praktyki bezpieczeństwa
- Nigdy nie publikuj kluczy API w kodzie źródłowym (np. na GitHubie). Używaj zmiennych środowiskowych.
- Stosuj oddzielne klucze dla środowisk testowych i produkcyjnych.
- Regularnie przeglądaj listę aktywnych kluczy i usuwaj te, które nie są już używane.
Jeśli potrzebujesz pomocy przy integracji, skontaktuj się z naszym zespołem technicznym pod adresem support@ventic.ai.