Gérer vos clés API Wix
Temps de lecture : 10 min
Clés API Wix sont des codes que vous pouvez générer pour autoriser un utilisateur ou une application et lui donner accès aux données de votre site et de votre compte.
Utilisez les clés API Wix pour accéder à des données telles que vos commandes, vos articles et vos événements pour construire vos propres fonctionnalités personnalisées et se connecter avec des services tiers.
Dans cet article, apprenez-en plus sur :
Générer une clé API Wix
Vous pouvez générer une clé API pour accéder aux données de votre site dans les paramètres de votre compte.
Important
- Par défaut, chaque clé API que vous générez a accès à tous les sites de votre compte. En effet, les clés API sont générées au niveau du compte.
- Pour plus de sécurité, chaque jeton de clé API que vous générez n'est affiché qu'une seule fois lorsque vous le créez.
- Il n'est pas possible d'afficher à nouveau le jeton d'une clé API après avoir fermé la fenêtre pop-up Vous avez généré une clé API . Assurez-vous de conserver votre token dans un endroit sûr afin de pouvoir y accéder à l'avenir.
Pour générer une clé API :
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur Générer une clé API .
- Saisissez un nom pour votre nouvelle clé API sous Détails de la clé.
- Sélectionnez les autorisations que vous souhaitez attribuer à la clé API.
- L'autorisation de base pour renvoyer les ID de tous les sites sur votre compte est sélectionnée par défaut. Il ne peut pas être désélectionné.
- Pour des raisons de sécurité, n'ajoutez que les autorisations dont vous avez besoin. En savoir plus
- Cliquez sur Générer une clé .
- Cliquez sur Envoyer le code pour envoyer un code de vérification à 6 chiffres à l'adresse e-mail liée à votre compte.
- Obtenez votre code de vérification dans l'e-mail.
- Saisissez le code dans la fenêtre pop-up Vérifier votre compte.
- Cliquez sur Vérifier et générer la clé.
- Cliquez sur Copier le jeton et fermer .
- Conservez le jeton dans un endroit sûr.
Suggestion :
Si vous avez besoin d'une autre clé API avec les mêmes autorisations, vous pouvez faire pivoter la clé API ou dupliquer la clé API .
Faire pivoter une clé API Wix
Vous pouvez faire pivoter une clé API pour créer un nouveau jeton tout en conservant le même nom, la même description et les mêmes autorisations. Après la rotation d'une clé API, toute personne qui y avait précédemment accès ne pourra plus l'utiliser et vous devrez partager le nouveau jeton avec elle.
Important :
- Après avoir fait pivoter une clé API, tout utilisateur ou toute appli qui l'a précédemment utilisée perdra immédiatement l'accès à vos données.
- Il n'est pas possible de récupérer un token précédent après avoir fait pivoter sa clé API.
Suggestion :
- Dans la plupart des cas, il est préférable de dupliquer la clé API, ajoutez le nouveau jeton à vos appels API, partagez le nouveau jeton avec tous les membres de l'équipe qui en ont besoin et supprimez l'ancienne clé API.
- Cela garantit que les API qui utilisent la clé n'auront pas d'interruption de service.
- Nous vous recommandons de ne faire tourner une clé API que si vous pensez que votre clé a été compromise.
Pour faire pivoter une clé API :
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur l'icône Plus d'actions
à côté de la clé API que vous souhaitez faire pivoter. - Sélectionnez Rotation.
- Cliquez sur Faire pivoter la clé dans la fenêtre pop-up.
- Cliquez sur Envoyer le code pour envoyer un code de vérification à 6 chiffres à l'adresse e-mail liée à votre compte.
- Obtenez votre code de vérification dans l'e-mail.
- Saisissez le code dans la fenêtre pop-up Vérifier votre compte.
- Cliquez sur Valider et faire pivoter la clé.
- Cliquez sur Copier le jeton et fermer .
- Conservez le jeton dans un endroit sûr.
Dupliquer une clé API Wix
Vous pouvez dupliquer l'une de vos clés API existantes si vous avez besoin d'une autre clé API avec les mêmes autorisations. Après avoir dupliqué une clé, vous pouvez également modifier sa description et ses autorisations si vous avez besoin de la personnaliser davantage.
Important
- Par défaut, chaque clé API que vous générez a accès à tous les sites de votre compte. En effet, les clés API sont générées au niveau du compte.
- Pour plus de sécurité, chaque jeton de clé API que vous générez n'est affiché qu'une seule fois lorsque vous le créez.
- Il n'est pas possible d'afficher à nouveau le jeton d'une clé API après avoir fermé la fenêtre pop-up Vous avez généré une clé API . Assurez-vous de conserver votre token dans un endroit sûr afin de pouvoir y accéder à l'avenir.
Pour dupliquer une clé API :
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur l'icône Plus d'actions à côté de la clé API que vous souhaitez dupliquer.
- Sélectionnez Dupliquer.
- Saisissez un nouveau nom pour votre nouvelle clé API sous Détails de la clé.
- (Facultatif) Modifiez les autorisations attribuées à la clé API.
- L'autorisation de base pour renvoyer les ID de tous les sites sur votre compte est sélectionnée par défaut. Il ne peut pas être désélectionné.
- Pour des raisons de sécurité, n'ajoutez que les autorisations dont vous avez besoin. En savoir plus
- Cliquez sur Générer une clé .
- Cliquez sur Envoyer le code pour envoyer un code de vérification à 6 chiffres à l'adresse e-mail liée à votre compte.
- Obtenez votre code de vérification dans l'e-mail.
- Saisissez le code dans la fenêtre pop-up Vérifier votre compte.
- Cliquez sur Vérifier et générer la clé.
- Cliquez sur Copier le jeton et fermer.
- Conservez la clé dans un endroit sûr.
Modifier une clé API Wix
Vous pouvez mettre à jour le nom et les autorisations d'une clé API après l'avoir créée sur sa page Modifier la clé API .
Important :
Tout membre autorisé de votre équipe peut modifier les clés API de votre compte. Pour modifier les personnes autorisées à modifier vos clés API, accédez à la page Rôles et autorisations ou votre tableau de bord Partenaire si vous êtes un partenaire Wix.
Pour modifier une clé API :
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur l'icône Plus d'actions
à côté de la clé API que vous souhaitez modifier. - Sélectionnez Modifier.
- Modifiez le nom ou les autorisations de la clé API.
- Cliquez sur Enregistrer et fermer.
- Cliquez sur Envoyer le code pour envoyer un code de vérification à 6 chiffres à l'adresse e-mail liée à votre compte.
- Obtenez votre code de vérification dans l'e-mail.
- Saisissez le code dans la fenêtre pop-up Vérifier votre compte.
- Cliquez sur Vérifier et enregistrer les modifications.
Supprimer une clé API Wix
Vous pouvez supprimer à tout moment les clés API dont vous n'avez plus besoin.
Important :
- Tout utilisateur ou application qui avait précédemment accès à la clé API perdra l'accès à vos données après que vous les aurez supprimées.
- Il n'est pas possible de récupérer une clé API après l'avoir supprimée.
Pour supprimer une clé API
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur l'icône Plus d'actions à côté de la clé API que vous souhaitez supprimer.
- Sélectionnez Supprimer.
- Cliquez sur Supprimer dans la fenêtre pop-up.
- Cliquez sur Envoyer le code pour envoyer un code de vérification à 6 chiffres à l'adresse e-mail liée à votre compte.
- Obtenez votre code de vérification dans l'e-mail.
- Saisissez le code dans la fenêtre pop-up Vérifier votre compte.
- Cliquez sur Vérifier et supprimer la clé.
Choisir les autorisations de la clé API Wix
Les autorisations que vous attribuez à votre clé API contrôlent les types de données auxquelles les appels d'API à l'aide de la clé peuvent accéder.
Par exemple, vous pouvez sélectionner l'autorisation Wix Stores pour autoriser uniquement l'accès aux données de la boutique de votre site, y compris les articles, les commandes et les devises.
Important :
La plupart des autorisations donnent automatiquement un accès en lecture et en écriture aux données de votre site. Il est important de n'attribuer que les autorisations dont vous avez besoin à votre clé API afin de ne pas donner plus d'accès aux données de votre site que nécessaire. En savoir plus sur les autorisations et la sécurité des clés API
Vous pouvez consulter les autorisations d'une clé API en cliquant sur Afficher les autorisations à côté d'elle sur la page Clés API .
Vous pouvez également modifier les autorisations d'une clé API à tout moment si vous devez ajouter ou supprimer des autorisations.
Pour modifier les autorisations d'une clé :
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur l'icône Plus d'actions à côté de la clé API que vous souhaitez modifier.
- Sélectionnez Modifier.
- Sélectionnez les nouvelles autorisations que vous souhaitez attribuer à la clé API sous Autorisations .
- Cliquez sur Enregistrer et fermer.
- Cliquez sur Oui, Enregistrer les modifications dans la fenêtre pop-up.
- Cliquez sur Envoyer le code pour envoyer un code de vérification à 6 chiffres à l'adresse e-mail liée à votre compte.
- Obtenez votre code de vérification dans l'e-mail.
- Saisissez le code dans la fenêtre pop-up Vérifier votre compte.
- Cliquez sur Vérifier et enregistrer les modifications.
Obtenir votre identifiant de compte
Pour utiliser les API au niveau du site, vous devez inclure votre ID de compte Wix dans l'en-tête de votre demande HTTP. Vous pouvez obtenir votre identifiant de compte sur la page Clés API des paramètres de votre compte.
Pour obtenir votre identifiant de compte :
- Accédez à Clés API dans les paramètres de votre compte.
- Cliquez sur Copier la pièce d'identité sous Identifiant du compte .
Vous voulez en savoir plus sur l'utilisation des clés API Wix ?
Lisez notre article sur génération de demandes à l'aide de clés API.
Cela vous a-t-il aidé ?
|