jeffreyhyer/bamboohr-laravel

Laravel package to access the BambooHR API

BambooHR for Laravel 5

NOTE: This package currently requires PHP >= 7.0.0

If you have a need for PHP 5.x support let me know by opening an issue (or feel free to submit a pull request).

Installation

$ composer require jeffreyhyer/bamboohr-laravel

Laravel 5.5+

This package supports auto-discovery of the Service Provder and Facade, you can skip to the Configuration section below.

Laravel <= 5.4

For Laravel <= 5.4 you'll need to add the Service Provider and Facade to the config/app.php file.

<?php

'providers' => [
    // ...
    JeffreyHyer\BambooHR\ServiceProvider::class,
],

'aliases' => [
    // ...
    'BambooHR' => JeffreyHyer\BambooHR\Facade::class,
],

Configuration

In order to access the BambooHR API you'll need to configure your company's subdomain and provide an API key.

Add the following to the config/services.php file:

'bamboohr' => [
    'domain' => env('BAMBOOHR_DOMAIN'),
    'key' => env('BAMBOOHR_APIKEY'),
],

If you decide to use the .env file to store the domain and API Key (recommended) you'll need to add the following to your .env file:

BAMBOOHR_DOMAIN=company             # Company Subdomain (e.g. http://COMPANY.bamboohr.com/)
BAMBOOHR_APIKEY=0123456789abcdef    # API Key

Usage

Once installed you should be able to access the BambooHR API through the facade:

<?php

// Get employee directory
BambooHR::employees()->directory();

For full API documentation and additional usage options see https://jeffreyhyer.github.io/bamboohr/

bamboohr-laravel's Issues

Support Laravel 5.8

Currently it does not support Laravel 5.8.

Laravel 5.6

Can support 5.6.*? Love the non Laravel library, working on a new Laravel based project would love to continue to use your BambooHR package.

$response->hasErrors() returning false even if the calls return 503

I try to request using to bamboohr api using wrong subdomain and key.

$response->getCode()
returns 503

but when I do
$response->hasErros()
returns false

Employee ID not Returned

Hello,

When I add a new employee in BambooHR, the employee id of the newly created record is not being returned. Is there any way I can get it?

Thank you.