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.

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
Authentification unique et SCIM
Laissez votre équipe se connecter avec le fournisseur d’identité de votre entreprise, et ajoutez ou retirez des personnes dans Valdra depuis votre annuaire.
Exporter vos données et fermer l’espace de travail
Téléchargez tout votre espace en un seul fichier, et fermez l’espace quand vous partez, avec 30 jours pour changer d’avis.