Desks Professional et supérieur
Si tu développes une intégration avec deskbird, notre API publique te permet d’accéder et de gérer des données comme les réservations, les utilisateurs, les groupes, les ressources, le planning, et bien plus encore.
👉 Pour toute la documentation technique, rends-toi sur notre Developer Hub :
https://developer.deskbird.com
1. Cas d’usage disponibles
Avec l’API de deskbird, tu peux connecter les données de réservation et de présence à tes outils de lieu de travail existants pour automatiser des workflows, créer des tableaux de bord personnalisés et réduire le travail manuel. Voici quelques exemples populaires utilisés par nos clients pour générer rapidement de la valeur opérationnelle et améliorer l’expérience collaborateur.
- Intégration du contrôle d'accès : Accorde (et retire) automatiquement l’accès au bâtiment ou à une zone en fonction des réservations de poste ou de salle de réunion — ainsi, les employés ont le bon accès au bon moment, sans listes manuelles.
- Automatisation de la réservation de parking : Libère ou enregistre automatiquement les réservations via des scans de badge ou des données SIRH.
- Affichage dynamique & tableaux de bord de bureau : Affiche la disponibilité en temps réel et “qui est au bureau aujourd’hui” sur des écrans ou des pages intranet — pour aider les équipes à planifier leurs journées au bureau et trouver un espace rapidement.
- Nettoyage et services à la demande : Utilise les données d’utilisation réelles (par exemple, les réservations enregistrées) pour nettoyer et entretenir uniquement les zones réellement utilisées — ce qui permet de réduire les passages inutiles et de concentrer les efforts là où c’est nécessaire.
- Analyse des No-shows (en raison de l'absence d'enregistrement) / réservations fantômes : Analyse les tendances entre réservations et enregistrements pour repérer les No-shows (en raison de l'absence d'enregistrement) et la capacité inutilisée — et utilise ces informations pour améliorer la gestion des espaces et les règles de réservation.
- Widgets “Trouver mon équipe” : Propose une vue simple de la présence de l’équipe dans des outils comme ton intranet ou ta plateforme collaborative — pour que chacun sache quand ses collègues prévoient d’être au bureau.
- Analyse avancée : Connecte-toi à des outils BI comme PowerBI ou Looker pour analyser les tendances d’utilisation et d’occupation.
💡 Remarque : Ce ne sont que quelques exemples. Si tu partages ta configuration et tes objectifs, nous serons ravis d’en discuter avec toi et de t’aider à trouver la meilleure approche d’intégration.
2. Endpoints disponibles
Pour les schémas de requête/réponse et des exemples, consulte le Developer Hub.
Règles de détection de bureau : l’endpoint Lists company network configurations renvoie les règles réseau utilisées par ton entreprise pour la détection de bureau dans deskbird intelligence, afin que tu puisses les connecter à tes propres outils. Les résultats peuvent être filtrés par bureau et sont paginés. Chaque règle indique aussi avec quel autre bureau elle est en conflit, ainsi que le signal et la valeur concernés. Une clé API ne retourne que les données de sa propre entreprise. Pour exporter ces mêmes règles au format CSV, consulte Configurer la détection de bureau et la configuration réseau pour deskbird Dock.
3. Premiers pas
Toute la documentation technique, les détails d’authentification et la liste des endpoints sont disponibles sur notre Developer Hub. Tu y trouveras aussi des exemples de payloads, des codes d’erreur et des guides d’intégration.
Pour créer une clé API, va dans Admin > Paramètres de l’entreprise > Clés API et clique sur Générer une clé (seuls les Admins globaux peuvent générer des clés). Dans la fenêtre Générer une clé, saisis un Nom (nom du projet), sélectionne API ou SCIM, choisis une période d’expiration (1 an, 2 ans, 3 ans ou illimitée), puis clique sur Générer une clé.
Ta nouvelle clé apparaîtra dans la liste, avec un aperçu de la clé et des détails comme Créé par, Créé le, Dernière utilisation et Expire le.
Tu peux supprimer des clés en utilisant l’icône de corbeille — cette action est irréversible.
💡 Remarque : Si ton entreprise utilise déjà la Synchro du SIRH pour le Provisionnement des utilisateurs, tu ne peux pas créer de Clés SCIM.
4. Gestion des clés API
Les Admins globaux peuvent gérer tout le cycle de vie des clés API publiques, y compris la création, la configuration de l’expiration et le suivi.
Aucune limite de clés API
Il n’y a aucune limite au nombre de clés API publiques que tu peux générer. Crée-en autant que nécessaire pour tes intégrations.
Paramètres d’expiration
Lors de la génération d’une clé, tu peux définir son expiration sur l’une des périodes suivantes :
- 1 an
- 2 ans
- 3 ans
- Illimitée
E-mails de rappel d’expiration
deskbird envoie automatiquement des e-mails de rappel avant l’expiration d’une clé API :
- 3 mois avant l’expiration
- 2 semaines avant l’expiration
Le rappel est envoyé à la personne qui a créé la clé, tant que son compte est toujours actif. Si le compte du créateur n’est plus actif, l’e-mail est envoyé à tous les Admins globaux à la place.
5. Besoin d’aide ?
Tu as un cas d’usage précis en tête ? Tu ne sais pas si quelque chose est possible ?
👉 Contacte support@deskbird.com. Nous serons ravis de t’aider à cadrer ton intégration.