Clés API
Une clé API permet à un agent IA ou à un script de travailler sur vos données VillaSlot sans votre mot de passe : lister les villas, trouver des créneaux libres, créer des clients et des réservations. La page Agents explique comment connecter un agent ; la référence API liste chaque appel.
Avant de commencer : la bonne organisation
Une clé appartient à une seule organisation : celle qui est sélectionnée dans votre sélecteur d’équipe au moment où vous la créez. Si vous gérez plusieurs organisations, passez d’abord sur celle où l’agent doit travailler.
Seuls les propriétaires et les administrateurs de cette organisation peuvent créer, voir et supprimer ses clés.
Créer une clé
Clés API dans la section Compte de la barre latérale, puis Créer une clé API.
Nom de la clé
Un nom qui dit qui l’utilise, comme Claude Code sur mon portable ou script d’import des réservations. C’est le seul moyen de distinguer les clés par la suite.
Expiration
Choisissez une date et une heure dans Expire le, ou cochez N'expire jamais. Une date dans le passé est refusée.
Créer, puis copier
Créer affiche Votre nouvelle clé API. Copiez-la maintenant et rangez-la en lieu sûr — un gestionnaire de mots de passe, ou la variable d’environnement que lit votre agent. Terminé ferme la fenêtre.
C’est la seule fois où vous voyez la clé. Le tableau n’affiche ensuite que La clé est masquée pour des raisons de sécurité. Vous l’avez perdue ? Supprimez-la et créez-en une nouvelle.
Laisser Expire le vide sans cocher N'expire jamais crée une clé qui n’expire jamais. Fixez une date si l’accès doit être temporaire.
Ce que la clé peut faire
La clé agit comme la personne qui l’a créée, dans cette organisation : rien de plus que ce qu’elle pourrait faire dans l’application, rien de moins. Si cette personne quitte l’organisation, la clé cesse aussitôt de fonctionner.
Tout ce que fait l’application n’est pas dans l’API — les paiements, les remboursements et les nuitées, entre autres, restent dans l’application. La page Agents liste ce qu’un agent peut gérer.
Révoquer une clé
Le tableau liste pour chaque clé son Nom, sa date de création (Créée) et sa date d’expiration (Expire). Le bouton de suppression demande une confirmation dans Supprimer la clé API, puis révoque la clé immédiatement : tout agent ou script qui l’utilise encore est refusé à partir de ce moment. C’est irréversible.
Révoquez une clé dès qu’elle ne sert plus, ou si elle a pu fuiter — par exemple après l’avoir collée dans un prompt partagé ou versionnée dans un dépôt.