library harvest-api

bestit/harvest-api

Harvest API written in PHP, optimised for Laravel.

bestit/harvest-api

, _(*1)

TODO, _(*2)

Installation

Step 1: Composer

From the command line, run:, _(*3)

composer require bestit/harvest-api

Step 2: Service Provider

For your Laravel app, open config/app.php and, within the providers array, append:, _(*4)

BestIt\Harvest\HarvestServiceProvider::class,

This will bootstrap the package into Laravel., _(*5)

Step 3: Facade

For your Laravel app, open config/app.php and, within the aliases array, append:, _(*6)

'Harvest' => BestIt\Harvest\Facade\Harvest::class,

This will add the Harvest Facade into Laravel., _(*7)

Step 4: Publishing config

From the command line, run:, _(*8)

php artisan vendor:publish --provider="BestIt\Harvest\HarvestServiceProvider"

Step 5: Configuration

Add the following entries to your environment (.env) file:, _(*9)

HARVEST_SERVER_URL // This is required...
HARVEST_USERNAME // This is required...
HARVEST_PASSWORD // This is required...

Usage within Laravel

// Get all users.
$users = Harvest::users()->all();

// For more examples check the ./examples directory.

Usage outside of Laravel

// Load dependencies
require_once __DIR__ . '/vendor/autoload.php';

$url = 'https://company.harvestapp.com';
$username = 'some@email.com';
$password = 'password';

$client = new \BestIt\Harvest\Client($url, $username, $password);

// Get all users.
$users = $client->users()->all();

// For more examples check the ./examples directory.

Todo

• Tests (perhaps use mockable.io?)
• Cover all endpoints