guzzle-toggl

A Toggl API client based on Guzzle PHP. Forked from AJT., _(*1)

Features

supports complete version 8 API with API Key authentication (thanks to @dirx)
- As the Toggl 6 Api will be deprecated on 1st september 2013 its removed in v0.8.
supports Toggl Report Api v2 (thanks to @dirx)

Installation

The library is available through Composer, so its easy to get it. Simply run this to install it:, _(*2)

composer require jamosaur/guzzle-toggl

Usage

To use the Toggl API Client simply instantiate the client with the api key. More information on the key and authentication available at https://github.com/toggl/toggl_api_docs/blob/master/chapters/authentication.md, _(*3)

<?php

require dirname(__FILE__).'/../vendor/autoload.php';

use Jamosaur\Toggl\TogglClient;
$toggl_token = ''; // Fill in your token here
$toggl_client = TogglClient::factory(array('api_key' => $toggl_token));

// if you want to see what is happening, add debug => true to the factory call
$toggl_client = TogglClient::factory(array('api_key' => $toggl_token, 'debug' => true));

Invoke Commands using our __call method (auto-complete phpDocs are included), _(*4)

<?php 

$toggl_client = TogglClient::factory(array('api_key' => $toggl_token));

$workspaces = $toggl_client->getWorkspaces(array());

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:, _(*5)

<?php 

$toggl_client = TogglClient::factory(array('api_key' => $toggl_token));

//Retrieve the Command from Guzzle
$command = $toggl_client->getCommand('GetWorkspaces', array());
$command->prepare();

$response = $command->execute();

$workspaces = $response['data'];

foreach($workspaces as $workspace){
    $id = $workspace['id'];
    print $workspace['name'] . "\n";
}

Examples

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., _(*6)

You can look at the services.json for details on what methods are available and what parameters are available to call them, _(*7)