Accès développeur

Gandi met à votre disposition une API publique. Pour pouvoir l’utiliser, vous aurez besoin d’une clé API, qui permettra d’authentifier les requêtes tout en identifiant le compte, les organisations et les produits dépendants de ce compte.

Important

La clé API est dépréciée. À la place vous pouvez utiliser la fonctionnalité des Jetons d’accès personnels, qui offrent des possibilités plus « fines » de paramétrage.

Créer une clé API

La clé n’est pas affichée dans le compte, pour des raisons de sécurité. Lorsque vous en aurez besoin, vous devrez la générer depuis le compte. Pour cela :

  1. Connectez-vous à votre compte Gandi, puis dans le menu utilisateur (s’ouvrant en cliquant sur le nom de l’utilisateur en haut à droite), cliquez sur « Paramètres utilisateur ».

  2. Dans le bloc Gestion des identifiants et de la sécurité, cliquez le bouton « Mots de passe et restrictions d’accès ».

  3. Vérifiez que vous êtes bien sur la page Options d’authentification (bouton bleu activé).

  4. Descendez en bas de la page jusqu’à voir le bloc Accès développeur

  5. Cliquez sur le lien « Ajouter une clé API ». Après authentification, le système affichera la clé API à utiliser. Vous devrez la copier et sauvegarder, car elle ne sera plus affichée.

Perte de votre clé API

Si vous deviez oublier ou perdre votre clé API, ou en cas de doutes liés à la sécurité, vous avez la possibilité de changer cette clé. Pour cela, suivez les mêmes instructions que ci-dessus. Si vous avez déjà une clé activée, le système affichera la date de création de la dernière clé API générée, suivie de deux boutons.

  • « Régénérer la clé API »

  • « Supprimer la clé API »

Le premier choix va invalider votre ancienne clé API et vous en affichez une nouvelle. Suivez les instructions (les mêmes que lors de la création de la clé) en n’oubliant pas de la sauvegarder.

Le second choix va invalider la clé actuelle, sans en générer de nouvelle. Il est donc impossible de, à partir de ce moment-là, d’utiliser l’API publique sur ce compte, les organisations et les produits en dépendant. Vous pouvez à tout moment recréer une clé API si le besoin s’en fait sentir.

N’hésitez pas à contacter le support clientèle Gandi pour toute question ou information supplémentaire.