Как да генерирам API ключ за ventic?

Интеграцията с платформата ventic изисква API ключ за удостоверяване на заявките. Тези ключове са уникални за вашата организация и осигуряват сигурен достъп до вашия продуктов каталог и търговски услуги.

Ето как да управлявате API ключовете:

1. Достъп до контролния панел за разработчици (Developer Dashboard)

Влезте в акаунта си в ventic и отидете в секцията Настройки > Разработчици (Settings > Developers). Там ще намерите раздела „API Keys“.

2. Генериране на нов ключ

За да създадете нов ключ:

1. Кликнете върху бутона „Create API Key“.
2. Дайте на ключа описателно име (напр. „Продукция - Главен магазин“ или „Тестване - Иван Иванов“).
3. Изберете обхвата на правата (Scopes). Препоръчваме да давате на ключовете само необходимите права (принцип на минималните привилегии).
4. Кликнете върху „Generate“.

3. Сигурно съхранение на ключа

След генерирането ключът ще ви бъде показан само веднъж.

• Важно: Копирайте ключа и го съхранете на сигурно място (напр. в мениджър на пароли или защитено хранилище за ключове във вашата инфраструктура).
• Забележка: От съображения за сигурност ventic няма да покаже целия ключ отново след затваряне на прозореца.

4. Използване на ключа в заявки

Всички заявки към ventic API интерфейса трябва да съдържат API ключа в HTTP заглавието X-API-Key.

Пример за използване с cURL:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: вашият_api_ключ_тук" \
     -H "Accept: application/json"

5. Ротация и изтриване на ключове

Ако подозирате, че ключът е бил разкрит, трябва незабавно да го анулирате.

• В контролния панел изберете ключа, който искате да премахнете, и кликнете върху „Revoke“ (Анулиране).
• След анулирането всяка заявка, използваща този ключ, ще бъде отхвърлена.
• Генерирайте нов ключ и актуализирайте вашата конфигурация.

Най-добри практики за сигурност

• Никога не публикувайте API ключове в изходния код (напр. в GitHub). Използвайте променливи на средата.
• Използвайте отделни ключове за тестови и производствени среди.
• Редовно преглеждайте списъка с активни ключове и премахвайте тези, които вече не се използват.

Ако имате нужда от помощ при интеграцията, свържете се с нашия технически екип на support@ventic.ai.