Comment générer une clé API ventic ?
L'intégration avec la plateforme ventic nécessite une clé API pour authentifier les requêtes. Ces clés sont uniques à votre organisation et offrent un accès sécurisé à votre catalogue de produits et à vos services commerciaux.
Voici comment gérer vos clés API.
1. Accéder au tableau de bord développeur
Connectez-vous à votre compte ventic et accédez à la section Paramètres > Développeurs (Settings > Developers). Vous y trouverez l'onglet "Clés API" (API Keys).
2. Générer une nouvelle clé
Pour créer une nouvelle clé :
- Cliquez sur le bouton "Créer une clé API" (Create API Key).
- Donnez à la clé un nom descriptif (par exemple, "Production - Boutique Principale" ou "Test - Jean Dupont").
- Choisissez les portées de permission (Scopes). Nous recommandons de n'accorder aux clés que les permissions nécessaires (principe du moindre privilège).
- Cliquez sur "Générer".
3. Stockage sécurisé de la clé
Une fois générée, la clé ne vous sera présentée qu'une seule fois.
- Important : Copiez la clé et enregistrez-la dans un endroit sûr (par exemple, dans un gestionnaire de mots de passe ou un coffre-fort de clés sécurisé dans votre infrastructure).
- Note : Pour des raisons de sécurité, ventic n'affiche plus la clé complète après la fermeture de la fenêtre.
4. Utilisation de la clé dans les requêtes
Toutes les requêtes vers l'API ventic doivent inclure la clé API dans l'en-tête HTTP X-API-Key.
Exemple d'utilisation avec cURL :
curl -X GET "https://api.ventic.ai/v1/products" \
-H "X-API-Key: votre_cle_api_ici" \
-H "Accept: application/json"
5. Rotation et suppression des clés
Si vous soupçonnez qu'une clé a été compromise, vous devez l'invalider immédiatement.
- Dans le tableau de bord, sélectionnez la clé que vous souhaitez supprimer et cliquez sur "Révoquer" (Revoke).
- Une fois révoquée, toute requête utilisant cette clé sera rejetée.
- Générez une nouvelle clé et mettez à jour votre configuration.
Bonnes pratiques de sécurité
- Ne publiez jamais de clés API dans le code source (par exemple sur GitHub). Utilisez des variables d'environnement.
- Utilisez des clés distinctes pour les environnements de test et de production.
- Examinez régulièrement la liste des clés actives et supprimez celles qui ne sont plus nécessaires.
Si vous avez besoin d'aide pour l'intégration, veuillez contacter notre équipe technique à support@ventic.ai.