karotz/karotz

PHP library for the Karotz REST API

1.0.1-alpha 2012-01-04 11:25 UTC

This package is auto-updated.

Last update: 2024-03-29 00:14:35 UTC


README

Installation

Old school

Download the latest version of KarotzPhp and add the Karotz namespace to your PSR-0 autoloading system, or simply require the autoload.php

Composer

{
    "require": {
        "karotz/karotz": ">=1.0.0-alpha"
    }
}

Usage

use Karotz\Karotz;

$kz = new Karotz('Interactive ID');

try {
	// Make flash your Karotz LED in red
	$response = $kz->ledPulse('FF0000', 500, 500);
	
	// Test the response
	if ($response->getStatus())
	    echo "Rabbit flashs red light!";
	else
	    echo $response->getCode().": ".$response->getDescription();

} catch(\Exception $e) {
	echo $e->getMessage();
}

Get the Interactive ID

To run, the Karotz REST API needs an Interactive ID, which is reset every 15 minutes. Check the official documentation to know how retrieve this ID. http://dev.karotz.com/api/interactiveid.html KarotzPhp is not involved in managing the life cycle of the Interactive ID, but provides a way to get it with the signed START method:

use Karotz\Karotz;

$kz = new Karotz();

// Open a session and save the Interactive ID in the Karotz object
$response = $kz->start('install ID', 'API key', 'secret key');

Features

Work in progress... waiting for some test

About

Requirements

  • Any flavor of PHP 5.3 should do

Author

License

KarotzPhp is licensed under the MIT License - see the LICENSE file for details