A Toggl API client based on Guzzle PHP
The library is available through Composer, so it's easy to get it. Simply run this to install it:
composer require ajt/guzzle-toggl
To use the Toggl API Client simply instantiate the client with the api key. More information on the key and authentication available at https://engineering.toggl.com/docs/authentication
<?php
require __DIR__.'/../vendor/autoload.php';
use AJT\Toggl\TogglClient;
$toggl_token = ''; // Fill in your token here
$toggl_client = TogglClient::factory(['api_key' => $toggl_token]);
// if you want to see what is happening, add debug => true to the factory call
$toggl_client = TogglClient::factory(['api_key' => $toggl_token, 'debug' => true]);
Invoke Commands using our __call
method (auto-complete phpDocs are included)
<?php
use AJT\Toggl\TogglClient;
$toggl_client = TogglClient::factory(['api_key' => $toggl_token]);
$workspaces = $toggl_client->getWorkspaces([]);
foreach($workspaces as $workspace){
$id = $workspace['id'];
print $workspace['name'] . "\n";
}
Or Use the getCommand
method (in this case you need to work with the $response['data'] array:
<?php
use AJT\Toggl\TogglClient;
$toggl_client = TogglClient::factory(['api_key' => $toggl_token]);
//Retrieve the Command from Guzzle
$command = $toggl_client->getCommand('GetWorkspaces', []);
$command->prepare();
$response = $command->execute();
$workspaces = $response['data'];
foreach($workspaces as $workspace){
$id = $workspace['id'];
print $workspace['name'] . "\n";
}
Copy the apikey-dist.php to apikey.php (in the root directory) and add your apikey. Afterwards you can execute the examples in the examples directory.
You can look at the services.json for details on what methods are available and what parameters are available to call them
Almost all the methods retain the same naming, but some parameters have changed.
The following endpoints now require a workspace_id
to be passed in the parameters:
project_id
)project_id
)project_id
)project_id
)project_id
)project_id
)The following endpoints now require a project_id
to be passed in the parameters:
The following endpoints are new:
The following endpoints have changed their parameters:
id
is now workspace_id
, for clarity)project_id
parameter, but instead accepts a workspace_id
parameterThe following endpoints have had their name changed, to match the toggl docs more closely:
The following endpoints have been removed:
Found a bug, open an issue, preferably with the debug output and what you did. Bugfix? Open a Pull Request and I'll look into it.
Thank you to several contributors over the years to keep this updated with toggl's api versions. See the contributor page for all of them https://github.com/arendjantetteroo/guzzle-toggl/graphs/contributors
The Toggl API client is available under an MIT License.