Przejdź do głównej treści
BambooHR

BambooHR API: co robi z nim konektor do Odoo

Według dokumentacji BambooHR jego API to protokół REST, który odczytuje lub zmienia zasób za pomocą żądań HTTPS, i służy do pracy z danymi pracowników oraz tworzenia raportów w kilku formatach. Konektor FlexigoTech do Odoo korzysta z niego za Ciebie: loguje się przez OAuth bez klucza API, wywołuje określony zestaw tras, trzyma się limitów BambooHR i zapisuje każde wywołanie w Odoo.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 19 listopada 2026

Najważniejsze

Moduł
BambooHR
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
4 min

Czym jest API BambooHR

BambooHR nazywa je otwartym API, które ułatwia integrację innych aplikacji z BambooHR. Każda firma ma własny adres. Według dokumentacji {companyDomain} zastępujesz tekstem, który w adresie BambooHR Twojej firmy stoi przed .bamboohr.com.

Konektor buduje każde wywołanie jako https://{subdomena}.bamboohr.com plus trasa. Nigdy nie używa innego adresu zwróconego przez BambooHR i sprawdza serwer po zbudowaniu adresu URL, więc żadne wywołanie nie trafi gdzie indziej.

Bez klucza API: OAuth

Wiele osób szuka, jak wygenerować klucz API w BambooHR. Z tym konektorem nie jest Ci potrzebny. Dokumentacja BambooHR zaleca twórcom aplikacji wdrożenie przepływu OAuth i właśnie tak działa aplikacja FlexigoTech:

  1. W BambooHR › Konfiguracja › Połącz BambooHR wpisujesz swoją subdomenę.
  2. Potwierdzasz, że Twoi pracownicy wiedzą, że łączysz oba systemy.
  3. Administrator BambooHR zatwierdza aplikację na ekranie samego BambooHR.

FlexigoTech Cloud obsługuje tokeny, które BambooHR wydaje naszej aplikacji, i co godzinę odnawia dostęp. Twoje Odoo przechowuje ten dostęp w polach, które mogą czytać tylko administratorzy, i wywołuje BambooHR bezpośrednio. Twoi pracownicy, ich nieobecności i ich godziny nie przechodzą przez FlexigoTech Cloud. Jeśli BambooHR odpowie błędem 401, konektor raz odnawia dostęp i raz powtarza wywołanie.

Jakie trasy API wywołuje

Zmienieni pracownicy
GET /api/v1/employees/changed z parametrem since: którzy pracownicy zmienili się od ostatniego przebiegu.
Dane pracowników
POST /api/v2/datasets/employee/data, strona po stronie.
Nieobecności
/api/v1/time-off/requests, aby czytać wnioski i, jeśli to włączysz, zapisywać je.
Webhooki
POST /api/v1/webhooks, aby zarejestrować webhook konektora.

Każde wywołanie niesie Authorization: Bearer, Accept: application/json i własny X-Request-ID. Nie podąża za przekierowaniami. Czeka 10 sekund na połączenie i 60 na odczyt, 120 przy pobieraniu plików.

Wywołania API BambooHR w Odoo
BambooHR › Monitorowanie › Wywołania API: każde wywołanie z metodą, trasą, statusem i X-Request-ID. Jedno z nich zakończyło się błędem i jest zaznaczone na czerwono.

Limity: 429, Retry-After i błędy

Połączenie ma ustawienie Maks. liczba żądań na sekundę, które zaczyna się od 5. To tempo dzielą cztery rodzaje pracy konektora: kolejka, synchronizacja, zadania dzienne i tygodniowe.

Gdy BambooHR odpowiada błędem 429, konektor postępuje tak:

  • Z Retry-After całe połączenie czeka tyle, ile podaje BambooHR, od 1 do 3600 sekund, albo 60, jeśli nic nie podaje. Potem przez 10 minut pracuje w połowie tempa.
  • Jeśli 429 przychodzi bez Retry-After przy tworzeniu pracownika (POST /api/v1/employees), to jest to limit pracowników Twojego konta BambooHR i wywołanie nie jest ponawiane.
  • Przy 500, 502, 503 albo awarii sieci czeka 1 minutę, 5 minut, 30 minut, 2 godziny i 6 godzin. Szósta próba liczy się jako nieudana.

Każde wywołanie zostawia wiersz w Wywołania API, z metodą, szablonem trasy, statusem, identyfikatorem żądania, milisekundami i Retry-After. Nigdy nie zapisuje treści wiadomości, tokenów ani parametrów zapytania.

Webhooki: tylko sygnalizują zmianę

Konektor rejestruje w BambooHR własny webhook. Dostawy przychodzą podpisane, a odbiornik odpowiada w mniej niż sekundę, niczego nie zapisując w połączeniu. Dostawa uruchamia tylko odczyt: źródłem prawdy pozostaje API, a sprawdzanie co 15 minut działa dalej, nawet jeśli webhook zawiedzie. Z każdej dostawy zachowuje typ, godzinę, companyId, employeeId i zmienione pola, przez 8 dni.

Zdarzenia webhooka BambooHR w Odoo
BambooHR › Monitorowanie › Zdarzenia webhooka: dwie dostawy employee.updated, już przetworzone, z identyfikatorem pracownika w BambooHR.

Oto zaplanowane akcje, które pracują z API:

  • Kolejka, co minutę: dostawy webhooków i to, co Odoo ma wysłać do BambooHR.
  • Synchronizacja przyrostowa, co 15 minut.
  • Zadania dzienne, o 02:00 czasu lokalnego każdej firmy.
  • Uzgadnianie, raz w tygodniu.

Nieobecności przechodzą przez to samo API, a to, jak trafiają do Odoo, wyjaśnia artykuł BambooHR nieobecności w Odoo.

Pytania o API BambooHR i Odoo

Czy potrzebuję klucza API BambooHR?

Nie. Połączenie używa OAuth: wpisujesz subdomenę w Odoo, a administrator BambooHR zatwierdza aplikację FlexigoTech.

Czy moje dane przechodzą przez FlexigoTech Cloud?

Nie. Twoje Odoo wywołuje API BambooHR bezpośrednio. FlexigoTech Cloud autoryzuje połączenie, odnawia dostęp, pilnuje synchronizacji i powiadamia Cię, gdy się nie powiedzie.

Ile to kosztuje?

Licencja modułu kosztuje 9 € za wersję Odoo w Odoo Apps. Potrzebny jest też FlexigoTech Cloud, plan Konektor: Standard, 49 €/mies. lub 490 €/rok, albo Pro, 98 €/mies. lub 980 €/rok, bez VAT. Masz 14 dni bezpłatnego okresu próbnego. Cena obejmuje dwa miesiące pomocy przy uruchomieniu oraz, dopóki masz subskrypcję, aktualizacje i wsparcie, zgodnie z naszymi warunkami sprzedaży w wersji 2.2. Strona konektora BambooHR zbiera to wszystko.

Z jakimi wersjami Odoo działa?

Odoo 17, 18, 19 i 20, na Odoo.sh albo na Twoim własnym serwerze. Nie działa w Odoo Online. Twoje konto BambooHR i jego opłaty są osobno.

Czytaj dalej

BambooHR nieobecności w Odoo krok po krokuJak wnioski o nieobecność, salda i dni wolne firmy z BambooHR trafiają do Odoo, kto je zatwierdza i z jakimi opcjami startuje konektor.BambooHR płace w Odoo: czego nikt Ci nie mówiBambooHR Payroll wypłaca pensje pracownikom w USA, a konektor nie pobiera jego list płac. Co przenosi do Wynagrodzeń w Odoo: premie, prowizje i potrącenia.BambooHR onboarding w Odoo: jedno zatrudnienie i jedno odejście krok po krokuCo dzieje się w Odoo, gdy w BambooHR zatrudniasz lub zwalniasz pracownika: dział, stanowisko, plan wdrożenia i odejście, na konkretnym przykładzie.Co to jest BambooHR i gdzie ma swoje miejsce obok OdooCzym jest BambooHR według niego samego, jego pojęcia z odpowiednikami w Odoo i co konektor FlexigoTech robi z danymi Twoich pracowników.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła

  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:5
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:7
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:11
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:37
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:96
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:39
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_client.py:260
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_connection.py:248
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:278
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/hr_employee_sync.py:491
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_engine.py:512
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:1
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): models/bamboohr_webhook_event.py:30
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): data/crons.xml
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): views/bamboohr_menus.xml
  • Kod modułu: flexigo_bamboohr 20.0 (b018498c): static/description/index.html
  • documentation.bamboohr.com/docs/getting-started
  • flexigotech.com/pl/integracja-bamboohr-odoo.html