Aller au contenu
Aide Valdra
Compte et facturation

Clés d’API

Créez une clé pour que vos propres systèmes lisent votre état de confidentialité et de conformité depuis l’API de Valdra.

À quoi ça sert

Vos propres outils, comme un tableau de bord ou un script, peuvent lire votre état dans Valdra. Chaque outil utilise sa propre clé d’API. Vous pouvez révoquer une clé à tout moment.

Avant de commencer

  • Forfait : Professionnel et Entreprise. Professionnel compte 10 clés, Entreprise n’a pas de limite. Les clés API et le serveur MCP sont inclus dans les forfaits Professionnel et Entreprise.
  • Rôle : seul un Administrateur peut créer ou révoquer des clés. Un Auditeur peut voir la liste.
  • À avoir sous la main : un nom pour la clé qui indique où elle sert.

Étapes

Ouvrez Clés d’API

Dans le menu, ouvrez Compte, puis cliquez sur Clés d’API sous Développeurs.

Nommez la clé et choisissez son accès

Entrez le Nom de la clé, par exemple l’outil qui l’utilisera. Choisissez Lecture seule, ou Lecture et écriture (crée des incidents et des demandes).

Choisissez Lecture seule sauf si l’outil doit créer des dossiers.

Cliquez sur Créer la clé

Vous verrez Clé API créée; sauvegardez-la maintenant et la clé complète. C’est la seule fois que la clé complète sera affichée. Cliquez sur Copier et conservez-la en lieu sûr.

Consultez la documentation

Cliquez sur Voir la documentation pour ouvrir la Documentation de l’API partenaire, avec chaque requête, ses paramètres et un exemple de réponse.

La page de documentation de l’API partenaire.
La page de documentation de l’API partenaire.

Ce que vous verrez

Vos clés sont listées sous Vos clés, avec leur date de création et de dernière utilisation. Pour arrêter une clé, cliquez sur Révoquer à côté.

Si votre forfait passe à un forfait sans l’API, les clés existantes sont conservées, mais leurs requêtes sont refusées jusqu’à ce que vous passiez au forfait Professionnel.

Erreurs fréquentes et solutions

Vous voyez Les clés API et le serveur MCP sont inclus dans les forfaits Professionnel et Entreprise. Votre forfait n’inclut pas de clés. Cliquez sur Voir les abonnements.

Vous voyez Passer à un plan supérieur pour en ajouter. Toutes les places de clés sont utilisées. Révoquez une clé inutile, ou passez à un forfait supérieur.

Vous avez perdu une clé. Elle ne peut plus être affichée. Révoquez-la et créez-en une nouvelle.

Si ça n’a pas fonctionné

Échec de la création de la clé API. Attendez un instant et cliquez de nouveau sur Créer la clé.

Échec de la révocation de la clé. Veuillez réessayer. Cliquez de nouveau sur Révoquer.

Erreur réseau. Veuillez réessayer. Vérifiez votre connexion Internet et réessayez.

Étape suivante

Voyez toutes les connexions de votre espace.

Sur cette page