A PHP wrapper for the BambooHR API
You will need two pieces of information to get started.
- The company subdomain of your BambooHR account. If you access bamboo at hamsterfarm.bamboohr.com, this is "hamsterfarm"
- An API key. You can find instructions on obtaining an API key here
- Install with composer
composer require bamboohr/api
Once you have that, the following code will get a directory of employees (as long as your user is able to access the directory)
<?php
include "BambooHR/API/API.php";
use \BambooHR\API\BambooAPI;
$bhr = new API("<company_subdomain>");
$bhr->setSecretKey("<bar>");
$response = $bhr->getDirectory();
if($response->isError()) {
trigger_error("Error communicating with BambooHR: " . $response->getErrorMessage());
}
$simplexml = $response->getContent();
...
?>
After that, you may want to explore the employee api, or just look through the wrapper code.
To get JSON output, change the following line :
$bhr = new API("<company_subdomain>");
to this:
$bhr = new API("<company_subdomain>", new BambooJSONHTTP());