ixolit/dislo-sdk

Client library for Dislo APIs

ixoplan-sdk

PHP SDK for the Ixoplan API, _(*1)

Installation

Simply add ixolit/ixoplan-sdk and a provider of ixolit/ixoplan-sdk-http (e.g. ixolit/ixoplan-sdk-http-guzzle) to your composer.json, e.g:, _(*2)

{
    "name": "myvendor/myproject",
    "description": "Using ixoplan-sdk",
    "require": {
        "ixolit/ixoplan-sdk": "*",
        "ixolit/ixoplan-sdk-http-guzzle": "*"
    }
}

Usage

Instantiate the Client

The client is designed for different transport layers. It needs a RequestClient interface (e.g. HTTPRequestClient) to actually communicate with Ixoplan., _(*3)

use Ixolit\Dislo\Client;
use Ixolit\Dislo\HTTP\Guzzle\GuzzleHTTPClientAdapter;
use Ixolit\Dislo\Request\HTTPRequestClient;

$httpAdapter = new GuzzleHTTPClientAdapter();

$httpClient = new HTTPRequestClient(
    $httpAdapter,
    $host,
    $apiKey,
    $apiSecret
);

$apiClient = new Client($httpClient);

Most methods related to user data can be used with either a user ID, a \Ixolit\Dislo\WorkingObjects\User object or an authentication token. However, the less secure options have to be requested explicitely by passing $forceTokenMode = false to the constructor. Don't use this option unless you really need it, e.g. for implementing administrative functionality., _(*4)

Login

Authenticate user, retrieve token and user data:, _(*5)

$apiClient = new \Ixolit\Dislo\Client($httpClient);

try {
    $authResponse = $apiClient->userAuthenticate(
        $userEmail,
        $password,
        $ipAddress
    );

    $authToken = $authResponse->getAuthToken();
    setcookie('authToken', $authToken);

    $user = $response->getUser();
    echo $user->getLastLoginDate();
}
catch (\Ixolit\Dislo\Exceptions\AuthenticationInvalidCredentialsException $e) {
    // invalid credentials
    echo $e->getMessage();
}

Get user from token:, _(*6)

$token = getcookie('authToken');

$apiClient = new \Ixolit\Dislo\Client($httpClient);

try {
    $user = $apiClient->userGet($token);
}
catch (\Ixolit\Dislo\Exceptions\InvalidTokenException $e) {
    // token invalid, e.g. expired
    setcookie('authToken', null, -1);
}
catch (\Ixolit\Dislo\Exceptions\DisloException $e) {
    // other, e.g. missing arguments
}

A token's expiry time is extended automatically on usage., _(*7)

Verify a token, explicitly extend its expiry time and optionally change its lifetime:, _(*8)

$token = getcookie('authToken');

$apiClient = new \Ixolit\Dislo\Client($httpClient);

try {
    $response = $apiClient->userExtendToken($token, $ipAdress, 3600);
    $authToken = $response->getAuthToken();
    echo $authToken->getValidUntil()->format('c');
}
catch (\Ixolit\Dislo\Exceptions\InvalidTokenException $e) {
    // token invalid, e.g. expired
    setcookie('authToken', null, -1);
}
catch (\Ixolit\Dislo\Exceptions\DisloException $e) {
    // other, e.g. missing arguments
}

Deauthenticate:, _(*9)

$apiClient->userDeauthenticate($token);
setcookie('authToken', null, -1);

Packages

Retrieve a list of packages, optionally filtered by service ID:, _(*10)

$apiClient = new \Ixolit\Dislo\Client($httpClient);

$response = $apiClient->packagesList("1");

foreach ($response->getPackages() as $package) {
    echo $package->getDisplayNameForLanguage('en')->getName(), "\n";
}

Subscriptions

Retrieve a list of subscriptions for a user:, _(*11)

$apiClient = new \Ixolit\Dislo\Client($httpClient);

$response = $apiClient->subscriptionGetAll($token);

foreach ($response->getSubscriptions() as $subscription) {
    print_r([
        'status' => $subscription->getStatus(),
        'active' => $subscription->isActive(),
        'startedAt' => $subscription->getStartedAt()->format('c'),
        'package' => $subscription->getCurrentPackage()->getDisplayNameForLanguage('en')->getName(),
        'price (EU)' => $subscription->getCurrentPeriod()->getBasePriceForCurrency('EUR')->getAmount(),
        'metaData' => $subscription->getProvisioningMetaData(),
    ]);
}

Search API

Run a parametrized query against the search database in Ixoplan, pass a file resource to stream the returned data to., _(*12)

$apiClient = new \Ixolit\Dislo\Client($httpClient);

$date = date('Y-m-d');
$file = fopen('/path/to/file', 'w');

$apiClient->exportStreamQuery(
    'select * from users where last_indexed_at > :_last(date)',
    ['last' => $date],
    $file
);