trekksoft/sdk

TrekkSoft SDK

Friday, July 27, 2018
by trekksoft
Repository
0 Watchers
0 Stars
1,349 Installations

0 Dependents
0 Suggesters
0 Forks
0 Open issues
15 Versions
5 % Grown

The README.md

Trekksoft SDK

Overview

This is PHP SDK for Trekksoft API., _(*1)

Installation

To install SDK into your project you need to use composer (see https://getcomposer.org/). And then run:, _(*2)

composer require trekksoft/sdk, _(*3)

Usage

Basic Setup

$credentials = [
    'clientId'      => '<your-client-id>',
    'clientSecret'  => '<your-client-secret>',
];

$provider = new \TrekkSoft\SDK\OAuth2\Provider\TrekkSoftProvider($credentials);


//Get activities list
$activities = $provider->getActivities();

//Get availabilities list
$availabilities = $provider->getAvailabilities();

//Get merchants a list of merchants which you can access 
$merchants  = $provider->getMerchants();

Demo

Check demo folder for example of usage of this SDK. To make it running you will need to copy config.inc.php.dist to config.inc.php and configure your client id and client secret in the new file., _(*4)

Then you can put these files under your webroot folder and run it though web server. E.g. http://localhost/trekksoft/activities.php, _(*5)

Models

All the data received from API is automatically wrapped into objects to be able to work with data easier. You can check these models under src/Model folder. High level models are Activity and Availability. Others are nested under these models., _(*6)

So for example to get occupancy of the availability item you need to do the following: $availability->getCapacityInfo()->getOccupancy()., _(*7)

Filter criteria

When making requests you can can use criteria objects for setting filter options:, _(*8)

TrekkSoft\SDK\Criteria\ActivityCriteria for activities
TrekkSoft\SDK\Criteria\AvailabilityCriteria for availabilities
TrekkSoft\SDK\Criteria\MerchantCriteria for merchants

E.g. the following will only return all activities of bus2alps merchant which contain "rome":, _(*9)

$criteria = new \TrekkSoft\SDK\Criteria\ActivityCriteria();
$criteria->setMerchant('bus2alps');
$criteria->setTitleLike('rome');

Availability Criteria example:, _(*10)

$criteria = new \TrekkSoft\SDK\Criteria\AvailabilityCriteria();
$criteria->setMerchant('demo');
$criteria->resetSeats()->resetBookingTime()->setStartsFrom(null)->setWithGuests(true);

Iterators

Each of the requests to provider returns iterator as a result rather than direct array of the requested objects. This is usable to automatically handle pagination and avoid sending large chunks of data. As you loop through iterator additional requests might be sent to the server as needed. If you want to get a flat array still, use iterator_to_array() method., _(*11)

Maintainers

This project is maintained by TrekkSoft Team., _(*12)

The Versions

27/07 2018

dev-master

9999999-dev http://developers.trekksoft.com/

TrekkSoft SDK

library sdk

TrekkSoft SDK

trekksoft/sdk

The README.md

Trekksoft SDK

Overview

Installation

Usage

Basic Setup

Demo

Models

Filter criteria

Iterators

Maintainers

The Versions

dev-master

The Requires

by Pavel Dubinin

0.3.10

The Requires

by Pavel Dubinin

0.3.9

The Requires

by Pavel Dubinin

0.3.8

The Requires

by Pavel Dubinin

0.3.7

The Requires

by Pavel Dubinin

0.3.6

The Requires

by Pavel Dubinin

0.3.5

The Requires

by Pavel Dubinin

0.3.4

The Requires

by Pavel Dubinin

dev-fix_guzzle_compatibility

The Requires

by Pavel Dubinin

0.3.3

The Requires

by Pavel Dubinin

0.3.2

The Requires

by Pavel Dubinin

0.3.1

The Requires

by Pavel Dubinin

0.3.0

The Requires

by Pavel Dubinin

0.2.0

The Requires

by Pavel Dubinin

0.1.0

The Requires