justijndepover / bullhorn-api

PHP client for the Bullhorn API

Bullhorn API

PHP Client for the Bullhorn API

Caution

This application is still in development and could implement breaking changes. Please use at your own risk.

Installation

You can install the package with composer

composer require justijndepover/bullhorn-api

Usage

Connecting to Bullhorn:

// note the state param: this can be a random string. It's used as an extra layer of protection. Bullhorn will return this value when connecting.
$bullhorn = new Bullhorn(CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, STATE);

// if you already possess authentication credentials, provide them:
$bullhorn->setAccessToken($accessToken);
$bullhorn->setRefreshToken($refreshToken);
$bullhorn->setTokenExpiresAt($expiresAt);
$bullhorn->setRestUrl($restUrl);
$bullhorn->setBHRestToken($BHRestToken);

// when one of the tokens (accesstoken, refreshtoken, BHRestToken) changes, a callback method is called. Giving you the opportunity to store them.
$bullhorn->setTokenUpdateCallback(function ($bullhorn) {
    // you should store away these tokens
    $bullhorn->getAccessToken();
    $bullhorn->getRefreshToken();
    $bullhorn->getTokenExpiresAt();
    $bullhorn->getRestUrl();
    $bullhorn->getBHRestToken();
});

// open the connection
$bullhorn->connect();

Your application is now connected. To start fetching data:

$bullhorn->get('entity/Candidate/5059165');

Security

If you find any security related issues, please open an issue or contact me directly at [email protected].

Contribution

If you wish to make any changes or improvements to the package, feel free to make a pull request.

License

The MIT License (MIT). Please see License File for more information.