Wat de BambooHR API is
BambooHR noemt het een open API waarmee u eenvoudig andere applicaties in BambooHR integreert. Elk bedrijf heeft een eigen adres. Volgens de documentatie vervangt u {companyDomain} door de tekst die vóór .bamboohr.com staat in de BambooHR-URL van uw bedrijf.
De connector bouwt elke aanroep als https://{subdomein}.bamboohr.com plus de route. Hij gebruikt nooit een ander adres dat BambooHR teruggeeft, en hij controleert de server nadat de URL is opgebouwd, zodat geen enkele aanroep ergens anders heen gaat.
Geen API-sleutel: OAuth
Veel mensen zoeken hoe ze in BambooHR een API-sleutel aanmaken. Met deze connector hebt u die niet nodig. De documentatie van BambooHR vraagt app-makers om een OAuth-flow in hun applicatie te bouwen, en dat doet de app van FlexigoTech:
- In
BambooHR › Configuratie › BambooHR verbindenvult u uw subdomein in. - U bevestigt dat uw werknemers weten dat u de twee systemen koppelt.
- Een beheerder van BambooHR keurt de app goed op het scherm van BambooHR zelf.
FlexigoTech Cloud beheert de tokens die BambooHR aan onze app geeft en vernieuwt de toegang elk uur. Uw Odoo bewaart die toegang in velden die alleen beheerders kunnen lezen en roept BambooHR rechtstreeks aan. Uw werknemers, hun verlof en hun uren gaan niet via FlexigoTech Cloud. Antwoordt BambooHR met een 401, dan vernieuwt de connector de toegang één keer en herhaalt hij de aanroep één keer.
Welke API-routes hij aanroept
- Gewijzigde werknemers
- GET /api/v1/employees/changed met de parameter since: welke werknemers sinds de vorige ronde zijn gewijzigd.
- Werknemersgegevens
- POST /api/v2/datasets/employee/data, pagina voor pagina.
- Verlof
- /api/v1/time-off/requests, om aanvragen te lezen en, als u het aanzet, te schrijven.
- Webhooks
- POST /api/v1/webhooks, om de webhook van de connector te registreren.
Elke aanroep draagt Authorization: Bearer, Accept: application/json en een eigen X-Request-ID. Hij volgt geen omleidingen. Hij wacht 10 seconden op de verbinding en 60 op het antwoord, 120 bij downloads.

BambooHR › Monitoring › API-aanroepen: elke aanroep met methode, route, status en X-Request-ID. Eén ervan eindigde met een fout en staat in het rood.De limieten: 429, Retry-After en fouten
De verbinding heeft de instelling Max. aanvragen per seconde, die op 5 begint. Dat tempo delen de vier soorten werk van de connector: de wachtrij, de synchronisatie, de dagelijkse en de wekelijkse taken.
Als BambooHR met een 429 antwoordt, doet de connector het volgende:
- Met Retry-After wacht de hele verbinding zo lang als BambooHR aangeeft, tussen 1 en 3600 seconden, of 60 als er niets staat. Daarna draait ze 10 minuten op half tempo.
- Komt de 429 zonder Retry-After bij het aanmaken van een werknemer (POST /api/v1/employees), dan is dat het werknemersmaximum van uw BambooHR-account, en wordt de aanroep niet herhaald.
- Bij een 500, een 502, een 503 of een netwerkstoring wacht hij 1 minuut, 5 minuten, 30 minuten, 2 uur en 6 uur. De zesde poging telt als mislukt.
Elke aanroep laat een regel achter in API-aanroepen, met de methode, het routesjabloon, de status, de request-ID, de milliseconden en de Retry-After. Hij slaat nooit de inhoud van berichten, tokens of de querystring op.
Webhooks: ze melden alleen een wijziging
De connector registreert zijn eigen webhook in BambooHR. Leveringen komen ondertekend binnen, en de ontvanger antwoordt binnen een seconde zonder iets op de verbinding te schrijven. Een levering start alleen een leesactie: de API blijft de bron van waarheid, en de controle om de 15 minuten loopt door, ook als een webhook mislukt. Van elke levering bewaart hij het type, het tijdstip, de companyId, de employeeId en de gewijzigde velden, 8 dagen lang.

BambooHR › Monitoring › Webhookgebeurtenissen: twee leveringen employee.updated, al verwerkt, met het werknemers-ID in BambooHR.Dit zijn de geplande acties die met de API werken:
- De wachtrij, elke minuut: webhookleveringen en wat Odoo naar BambooHR moet sturen.
- De incrementele synchronisatie, elke 15 minuten.
- De dagelijkse taken, om 02:00 uur lokale tijd van elk bedrijf.
- De afstemming, één keer per week.
Verlof loopt via dezelfde API, en hoe het in Odoo komt, leest u in BambooHR verlof in Odoo.
Vragen over de BambooHR API en Odoo
Heb ik een API-sleutel van BambooHR nodig?
Nee. De verbinding gebruikt OAuth: u vult uw subdomein in Odoo in en een beheerder van BambooHR keurt de app van FlexigoTech goed.
Gaan mijn gegevens via FlexigoTech Cloud?
Nee. Uw Odoo roept de BambooHR API rechtstreeks aan. FlexigoTech Cloud autoriseert de verbinding, vernieuwt de toegang, bewaakt de synchronisatie en waarschuwt u als die mislukt.
Wat kost het?
De modulelicentie kost € 9 per Odoo-versie op Odoo Apps. Daarnaast is FlexigoTech Cloud nodig, plan Connector: Standard, € 49 per maand of € 490 per jaar, of Pro, € 98 per maand of € 980 per jaar, excl. btw. U kunt 14 dagen gratis proberen. De prijs omvat twee maanden hulp om het werkend te krijgen en, zolang u het abonnement houdt, updates en ondersteuning, zoals onze verkoopvoorwaarden in versie 2.2 zeggen. De pagina van de BambooHR-connector zet alles op een rij.
Op welke Odoo-versies werkt hij?
Odoo 17, 18, 19 en 20, op Odoo.sh of op uw eigen server. Op Odoo Online werkt hij niet. Uw BambooHR-account en de kosten ervan staan hier los van.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
- Broncode van de module: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
- documentation.bamboohr.com/docs/getting-started
- flexigotech.com/nl/bamboohr-koppeling-odoo.html
