Aller au contenu principal
BambooHR

BambooHR API : ce qu'en fait le connecteur Odoo

Selon la documentation de BambooHR, son API est un protocole REST qui lit ou modifie une ressource par des requêtes HTTPS, et elle sert à manipuler les données des employés et à produire des rapports dans plusieurs formats. Le connecteur de FlexigoTech pour Odoo l'utilise pour vous : il se connecte en OAuth sans clé d'API, appelle un ensemble précis de routes, respecte les limites de BambooHR et consigne chaque appel dans Odoo.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 19 novembre 2026

L'essentiel

Module
BambooHR
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
4 min

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 :

  1. Dans BambooHR › Configuration › Connecter BambooHR, vous saisissez votre sous-domaine.
  2. Vous confirmez que vos employés savent que vous connectez les deux systèmes.
  3. 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.

Appels à l'API BambooHR dans Odoo
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.

Événements webhook de BambooHR dans Odoo
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

BambooHR absences dans Odoo, étape par étapeComment les demandes de congés, les soldes et les jours fériés de BambooHR arrivent dans Odoo, qui les approuve et avec quelles options démarre le connecteur.BambooHR paie dans Odoo : ce que personne ne vous ditBambooHR Payroll paie les salariés basés aux États-Unis, le connecteur n'importe pas ses cycles de paie. Ce qu'il transmet à la Paie d'Odoo : primes, retenues.BambooHR onboarding dans Odoo : une embauche et un départ, étape par étapeCe qui se passe dans Odoo quand vous embauchez ou faites partir un employé dans BambooHR : département, poste, plan d'onboarding et départ, avec un cas concret.BambooHR c'est quoi, et quelle place il prend à côté d'OdooCe qu'est BambooHR selon ses propres mots, ses termes avec leur équivalent dans Odoo et ce que fait le connecteur de FlexigoTech de vos données d'employés.
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