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:
- W
BambooHR › Konfiguracja › Połącz BambooHRwpisujesz swoją subdomenę. - Potwierdzasz, że Twoi pracownicy wiedzą, że łączysz oba systemy.
- 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.

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.

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
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
