library harvest-php-client

valsplat/harvest-php-client

A PHP Client for the Harvest V2 API

, _(*1)

(Unofficial) Harvest v2 API Client for PHP

Contributing

$ git clone git@github.com:valsplat/harvest-php-client.git
$ cd harvest-php-client
$ composer update -o

Installation

$ composer require valsplat/harvest-php-client

Endpoints

This API client is very much a work in progress and is incomplete at this time. You can only use the Client, Project, Task, TaskAssignment, User and UserAssignment endpoints. Feel free to create a Pull Request to increase coverage., _(*2)

Authentication

Authentication is done via providing your account ID and a personal access token:, _(*3)

$connection = new \Valsplat\Harvest\Connection();
$connection->setAccessToken('ACCESS_TOKEN');
$connection->setAccountId('ACCOUNT_ID');

Get your token and account ID here: https://id.getharvest.com/oauth2/access_tokens/new, _(*4)

Errors

The API client throws two exceptions:, _(*5)

• \Valsplat\Harvest\Exceptions\NotFoundException - Entity could not be found
• \Valsplat\Harvest\Exceptions\ApiException - Generic Api exception

Basic Usage

Each endpoint is accessible via its own method on the \Valsplat\Harvest\Harvest instance. The method name is singular, camelcased:, _(*6)

$vlak = new \Valsplat\Harvest\Harvest($connection);
$vlak->TaskAssignment();

Generic methods & filters

• list((array)params) - get a collection of entities. You find the available params per endpoint in the Harvest docs.
• get((int)id) - get a single entity via its id.
• create() - create given entity.
• update() - update given entity.
• save() - convenience method; calls update() if the entity already exists, create() otherwise.
• delete() - delete given entity.

Usage examples

Authentication and usage examples: example.php, _(*7)

TODO

• Tests w/ mocked http client
• Complete endpoint support
• Automatic marshaling of attributes