otoyinc/xio-php

X.IO integration library for PHP

X.IO API PHP Library

Author: [Mike Christopher] (mike.christopher (a) otoy (.) com), _(*1)

Company: OTOY, _(*2)

Version: 1.0.0, _(*3)

Date: 2015-01-08, _(*4)

Repository: http://github.com/otoyinc/xio-php/, _(*5)

Parts of this library are based on http://github.com/twilio/twilio-php and http://github.com/zencoder/zencoder-php, _(*6)

For more details on the X.IO API requirements visit http://docs.x.io/v1/docs, _(*7)

To start working with the library, create a new instance of the Services_XIO class, passing your API Key ID as the first parameter and API Secret Key as the second., _(*8)

$xio = new Services_XIO('R45KU9BJWTKM4ATGZNKF29LJZ', 'F2kiGEZuhv7D7AEujAiwgLKVjZjP28pa0P96pbiw');

Once you have created the object, you can use it to interact with the API. For full information, see the Documentation folder, but here is a quick overview of some of the functions that can be called:, _(*9)

$xio->streams->create($array);
$xio->streams->details($stream_id);
$xio->streams->cancel($stream_id);

Any errors will throw a Services_XIO_Exception. You can call getErrors() on an exception and it will return any errors received from the X.IO API., _(*10)

STARTING A STREAM

The Services_XIO_Streams object creates an stream session using cURL to send JSON formatted parameters to X.IO's API., _(*11)

Step 1

Visit the API documentation and build a sample request., _(*12)

Step 2

Copy the successful JSON string, starting with the first curly brace "{", and pass it as the parameters for a new Services_XIO_Streams object. Execute the script on your server to test that it works., _(*13)

Example

streams->create(
    array(
      "application_id" => "7cd9272c77ef44aeb460a70de434067a",
      "version_id" => "980a84ff564b4c459cc5a658fd3fa838"
    )
  );

  // Success if we got here
  echo "w00t! \n\n";
  echo "Stream ID: ".$stream->id."\n";
  echo "Application name: ".$stream->application->name."\n";
} catch (Services_XIO_Exception $e) {
  // If were here, an error occured
  echo "Fail :(\n\n";
  echo "Errors:\n";
  echo $e->getErrors()->error."\n\n";
  echo "Full exception dump:\n\n";
  print_r($e);
}

echo "\nAll Stream Attributes:\n";
var_dump($stream);

?>

VERSIONS

Version 1.0.0   - 2015-01-08    Initial release, supports streams.