Ce qu'est l'API de BambooHR
BambooHR la présente comme une API ouverte qui facilite l'intégration d'autres applications dans BambooHR. Chaque entreprise a sa propre adresse. D'après la documentation, il faut remplacer {companyDomain} par le texte qui précède .bamboohr.com dans l'URL BambooHR de votre entreprise.
Le connecteur construit chaque appel sous la forme https://{sous-domaine}.bamboohr.com suivi de la route. Il n'utilise jamais une autre adresse renvoyée par BambooHR, et il vérifie le serveur après avoir construit l'URL, pour qu'aucun appel ne parte ailleurs.
Pas de clé d'API : OAuth
Beaucoup de gens cherchent comment générer une clé d'API dans BambooHR. Avec ce connecteur, vous n'en avez pas besoin. La documentation de BambooHR demande aux éditeurs d'applications de mettre en place un flux OAuth, et c'est ce que fait l'application de FlexigoTech :
- Dans
BambooHR › Configuration › Connecter BambooHR, vous saisissez votre sous-domaine. - Vous confirmez que vos employés savent que vous connectez les deux systèmes.
- Un administrateur de BambooHR approuve l'application sur l'écran de BambooHR lui-même.
FlexigoTech Cloud gère les jetons que BambooHR délivre à notre application et renouvelle l'accès toutes les heures. Votre Odoo conserve cet accès dans des champs que seuls les administrateurs peuvent lire et appelle BambooHR directement. Vos employés, leurs congés et leurs heures ne passent pas par FlexigoTech Cloud. Si BambooHR répond par un 401, le connecteur renouvelle l'accès une fois et répète l'appel une fois.
Les routes de l'API qu'il appelle
- Employés modifiés
- GET /api/v1/employees/changed avec le paramètre since : les employés qui ont changé depuis le dernier passage.
- Données des employés
- POST /api/v2/datasets/employee/data, page par page.
- Congés
- /api/v1/time-off/requests, pour lire les demandes et, si vous l'activez, pour les écrire.
- Webhooks
- POST /api/v1/webhooks, pour enregistrer le webhook du connecteur.
Chaque appel porte Authorization: Bearer, Accept: application/json et son propre X-Request-ID. Il ne suit aucune redirection. Il attend 10 secondes pour se connecter et 60 pour lire, 120 pour les téléchargements.

BambooHR › Surveillance › Appels API : chaque appel avec sa méthode, sa route, son statut et son X-Request-ID. L'un d'eux s'est terminé par une erreur et apparaît en rouge.Les limites : 429, Retry-After et erreurs
La connexion a un réglage Requêtes max. par seconde, qui démarre à 5. Ce rythme est partagé par les quatre types de travail du connecteur : la file d'attente, la synchronisation, les tâches quotidiennes et les hebdomadaires.
Quand BambooHR répond par un 429, le connecteur fait ceci :
- Avec Retry-After, toute la connexion attend le temps indiqué par BambooHR, entre 1 et 3600 secondes, ou 60 s'il n'indique rien. Ensuite, elle tourne à mi-régime pendant 10 minutes.
- Si le 429 arrive sans Retry-After lors de la création d'un employé (POST /api/v1/employees), c'est le plafond d'employés de votre compte BambooHR, et l'appel n'est pas relancé.
- Avec un 500, un 502, un 503 ou une panne réseau, il attend 1 minute, 5 minutes, 30 minutes, 2 heures et 6 heures. La sixième tentative compte comme un échec.
Chaque appel laisse une ligne dans Appels API, avec la méthode, le modèle de route, le statut, l'identifiant de requête, les millisecondes et le Retry-After. Il n'enregistre jamais le contenu des messages, les jetons ni la chaîne de requête.
Webhooks : ils signalent seulement un changement
Le connecteur enregistre son propre webhook dans BambooHR. Les envois arrivent signés, et le récepteur répond en moins d'une seconde sans rien écrire sur la connexion. Un envoi ne fait que lancer une lecture : l'API reste la source de vérité, et l'interrogation toutes les 15 minutes continue même si un webhook échoue. De chaque envoi, il garde le type, l'heure, le companyId, l'employeeId et les champs modifiés, pendant 8 jours.

BambooHR › Surveillance › Événements webhook : deux envois employee.updated, déjà traités, avec l'identifiant de l'employé dans BambooHR.Voici les actions planifiées qui travaillent avec l'API :
- La file d'attente, chaque minute : les envois des webhooks et ce qu'Odoo doit envoyer à BambooHR.
- La synchronisation incrémentale, toutes les 15 minutes.
- Les tâches quotidiennes, à 02:00, heure locale de chaque société.
- Le rapprochement, une fois par semaine.
Les congés passent par cette même API, et leur arrivée dans Odoo est expliquée dans BambooHR absences dans Odoo.
Questions sur l'API BambooHR et Odoo
Ai-je besoin d'une clé d'API BambooHR ?
Non. La connexion utilise OAuth : vous saisissez votre sous-domaine dans Odoo et un administrateur de BambooHR approuve l'application de FlexigoTech.
Mes données passent-elles par FlexigoTech Cloud ?
Non. Votre Odoo appelle directement l'API de BambooHR. FlexigoTech Cloud autorise la connexion, renouvelle l'accès, surveille la synchronisation et vous prévient quand elle échoue.
Combien ça coûte ?
La licence du module coûte 9 € par version d'Odoo sur Odoo Apps. Il faut aussi FlexigoTech Cloud, plan Connecteur : Standard, 49 €/mois ou 490 €/an, ou Pro, 98 €/mois ou 980 €/an, HT. Vous avez 14 jours d'essai gratuit. Le prix comprend deux mois d'aide pour la mise en route et, tant que vous gardez l'abonnement, les mises à jour et l'assistance, comme le prévoient nos conditions de vente, version 2.2. La page du connecteur BambooHR résume tout.
Sur quelles versions d'Odoo fonctionne-t-il ?
Odoo 17, 18, 19 et 20, sur Odoo.sh ou sur votre propre serveur. Il ne fonctionne pas sur Odoo Online. Votre compte BambooHR et ses frais sont à part.
À lire aussi
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées
Sources
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
- Code du module : flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
- Code du module : flexigo_bamboohr 20.0 (b018498c): data/crons.xml
- Code du module : flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
- Code du module : flexigo_bamboohr 20.0 (b018498c): static/description/index.html
- documentation.bamboohr.com/docs/getting-started
- flexigotech.com/fr/connecteur-bamboohr-odoo.html
