Как создать API-ключ ventic?
Интеграция с платформой ventic требует API-ключа для аутентификации запросов. Эти ключи уникальны для вашей организации и обеспечивают безопасный доступ к вашему каталогу товаров и торговым сервисам.
Вот как управлять API-ключами:
1. Доступ к панели разработчика (Developer Dashboard)
Войдите в свой аккаунт ventic и перейдите в раздел Настройки > Разработчикам (Settings > Developers). Там вы найдете вкладку «API Keys».
2. Создание нового ключа
Чтобы создать новый ключ:
- Нажмите кнопку «Create API Key».
- Дайте ключу понятное имя (например, «Production - Main Store» или «Testing - Ivan Petrov»).
- Выберите области разрешений (Scopes). Мы рекомендуем предоставлять ключам только необходимые разрешения (принцип наименьших привилегий).
- Нажмите «Generate».
3. Безопасное хранение ключа
После создания ключ будет показан вам только один раз.
- Важно: Скопируйте ключ и сохраните его в надежном месте (например, в менеджере паролей или защищенном хранилище ключей в вашей инфраструктуре).
- Примечание: В целях безопасности ventic не будет показывать весь ключ снова после закрытия окна.
4. Использование ключа в запросах
Все запросы к API-интерфейсу ventic должны содержать 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.