Intégrations
Clés API et API de provisionnement utilisateur
L'API de provisionnement utilisateur vous permet de gérer votre équipe de manière programmatique. Vous pouvez inviter des utilisateurs, les retirer, lister les membres de l'équipe et leur utilisation, lister les invitations en attente, et créer des réservations depuis vos propres systèmes.
L'accès à l'API est authentifié avec des clés API, que le Propriétaire de l'espace de travail gère dans Paramètres → Clés API.
Bon à savoir
L'API de provisionnement utilisateur est activée sur demande. Si vous ne voyez pas la page Clés API, contactez-nous à contact@onecal.io pour demander l'accès.
Générer une clé API
- Allez dans Paramètres → Clés API et cliquez sur Générer une nouvelle clé.
- Donnez à la clé un nom qui décrit son usage.
- Choisissez le type d'accès : Accès complet ou Lecture seule. Les clés en lecture seule ne peuvent pas effectuer de modifications.
- Choisissez une expiration : 7 jours, 30 jours, 90 jours, 1 an, ou jamais.
La valeur de la clé n'est affichée qu'une seule fois, juste après sa génération. Assurez-vous de la copier immédiatement, vous ne pourrez plus la voir ensuite.
Utiliser l'API
Envoyez votre clé dans l'en-tête x-api-key. L'URL de base est :
https://app.onecal.io/api/v1
La référence complète de l'API, y compris l'authentification, la pagination, les limites de débit et chaque endpoint, se trouve sur apidocs.onecal.io.
Surveiller et révoquer les clés
La liste des clés API montre quand chaque clé a été générée, quand elle expire et quand elle a été utilisée pour la dernière fois, donc vous pouvez repérer les clés inutilisées ou sur le point d'expirer.
Cliquez sur Révoquer pour désactiver une clé. Les applications utilisant cette clé cessent de fonctionner immédiatement, et la révocation ne peut pas être annulée. Les clés appartenant à un utilisateur sont aussi révoquées automatiquement quand cet utilisateur est retiré de l'équipe.
