Skiddle PHP SDK

The purpose of the SDK is to allow for easy access to the Skiddle API. This will allow developers to easily communicate with the Skiddle API to pull through information about events, artists and venues, _(*1)

Requirements
Installation
Examples
Things to note
License
Contact

Requirements

The API requires PHP > 5.4.0, due to using autoloading and new array constructs. It also requires cURL to be enabled, which is normally done by default in PHP, but best to double check., _(*2)

To connect to the API, TLS v1.2 or above is required. This has been supported by Curl using OpenSSL since version 1.0.1, _(*3)

Installation

Download the SDK

There are a couple of ways to get the SDK integrated to your project, the easiest way is probably via composer:, _(*4)

"require": {
    "skiddle/skiddle-php-sdk": "1.0.0"
}

You can also clone the git repository, _(*5)

git clone https://github.com/Skiddle/skiddle-php-sdk

Or, simply download the zip here and unzip to your project., _(*6)

If using either of the last two methods, you will need to include the autoloader.php file in your project to load everything up, _(*7)

Get an API Key

Getting an API key is simple and free, simply go to https://www.skiddle.com/api/join.php to get one now, _(*8)

Integrate

Once you have the code and an API key, you are ready to get started!!, _(*9)

Examples

You can view code samples in the /demo/ directory included in the repo, _(*10)

Authenticate yourself

The first step is to simply authenticate yourself - just tell the SDK what your API Key is, _(*11)

try {
    $session = new SkiddleSDK\SkiddleSession(['api_key'=>'APIKEYGOESHERE']);
} catch (SkiddleSDK\SkiddleException $e) {
    echo $e->getMessage();
    exit();
}

If you don't want to store this in your code, you can add it to your server environment as SKIDDLE_API_KEY and the SDK will read from there., _(*12)

Get the class Ready

After you have successfully authenticated yourself, you then need to pass your credentials to the revelant class that you want to use. This combines your authentication info with the endpoint necessary to make the calls., _(*13)

To do this, simply call the setSession() method of the class you wish to use:, _(*14)

$events = new SkiddleSDK\Events;
try {
    $events->setSession($session);
} catch (SkiddleSDK\SkiddleException $e) {
    echo $e->getMessage();
    exit();
}

Add and Remove conditions

You are now ready to make calls to the API. You can now technically make a call to return listings, however the Skiddle SDK allows you to easily add or remove conditions to make your query specific to your needs., _(*15)

To add a condition, you just need to pass the field and value in the addCond() method:, _(*16)

$events->addCond('eventcode','CLUB');
$events->addCond('ticketsavailable','1);

Likewise, to remove conditions, just use the delCond() method, using only the field name:, _(*17)

$events->delCond('ticketsavailable');

Get Results

Once you have built up your filter list, you can then get your listings!, _(*18)

$listings = $events->getListings();

foreach($listings->results as $result) {...}

For a full list of arguments you can filter by, have a look here, _(*19)

Get a single result

If you need to get a single result, you can call getListing(), without having to build an array of arguments - just pass the relevant ID, _(*20)

For example:, _(*21)

$listing = $events->getListing(12345);

var_dump($listing);

Things to note

When querying eventcodes, try to keeo values uppercase. Passing CLUB will work, whereas passing club may return an error
When using the minDate and maxDate conditions, timestamps need to be in either Y-m-d or Y-m-dTH:i:s format.
Don't like objects? You can get results in array format by passing a boolean in getListings():, _(*22)
```
$listings = $events->getListings(true);

foreach($listings['results'] as $result) {...}
```
Check back for more