This is a simple Go library to utilise the Bamboo HR API.
To get the library, simply:
go get github.com/darrenparkinson/bamboohr
To use the library you can use the New helper function and provide your API Key and your Company Domain, or provide these directly to the Client struct.
To get an API Key, follow the instructions on the Bamboo HR site, but essentially:
To generate an API key, users should log in and click their name in the upper right-hand corner of any page to get to the user context menu. If they have sufficient permissions, there will be an "API Keys" option in that menu to go to the page.
Your company domain is the part before bamboohr.com, so for https://acmecorp.bamboohr.com it would be acmecorp.
package main
import (
"log"
"os"
"github.com/darrenparkinson/bamboohr"
)
func main() {
apikey := os.Getenv("BAMBOO_API_KEY")
bamboo, _ := bamboohr.New(apikey, "acmecorp", nil)
ctx := context.Background()
people, _ := bamboo.GetEmployeeDirectory(ctx)
for _, person := range people {
log.Println(person.ID, person.Displayname)
}
// Note: 0 is a special ID meaning the user that created the API Key
// If no field names are specified after the ID, then all fields will be fetched.
me, _ := bamboo.GetEmployee(ctx, "0", bamboohr.DisplayName, bamboohr.FirstName, bamboohr.LastName)
log.Println(me.ID, me.FirstName, me.LastName, me.DisplayName)
}A context is required for each API request, for which you can just provide context.Background(), but you can also provide a timeout for your requests if necessary:
ctx := context.Background()
ctx, _ = context.WithTimeout(ctx, 1*time.Second)
people, err := bamboo.GetEmployeeDirectory(ctx)
if err != nil {
log.Fatal(err)
}This will likely return a context deadline exceeded error since the request will take longer than 1 second.
There is an online reference for the package at [godoc.org/github.com/darrenparkinson/bamboohr][godoc-bamboohr].
Bamboo HR Documentation is available on their site.
So far, the following endpoints have been implemented:
Employees
Employee Files
Account Information
These have been removed temporarily due to some inconsistencies with the ID field returned from Bamboo.