ihasco/client-api-sdk

Client API SDK

iHasco Client API SDK

Create a new instance:, _(*1)

$ihasco = Ihasco\ClientSDK\Manager::create('your-api-key');

All calls to the API return either a Ihasco\ClientSDK\Responses\Response object or throw a Ihasco\ClientSDK\Exceptions\Exception., _(*2)

Programmes

All programmes

$response = $ihasco->programmes->all();
$allProgrammes = $response->getData();

Returns an array of Ihasco\ClientSDK\Responses\Programme objects, _(*3)

One programme

$response = $ihasco->programmes->one(int $programmeId);
$oneProgramme = $response->getData();

Returns a single Ihasco\ClientSDK\Responses\Programme object, _(*4)

Results

All results

$response = $ihasco->results->all();
$allResults = $response->getData();

Returns an array of Ihasco\ClientSDK\Responses\Result objects, _(*5)

One result

$response =  $ihasco->results->one(int $resultId);
$oneResult = $response->getData();

Returns a single Ihasco\ClientSDK\Responses\Result object, _(*6)

Users

All users

$response = $ihasco->users->all();
$allUsers = $response->getData();

Returns an array of Ihasco\ClientSDK\Responses\User objects, _(*7)

One user

Supply a userId or email address, _(*8)

$response = $ihasco->users->one(mixed $userId);
$oneUser = $response->getData();

Returns a single Ihasco\ClientSDK\Responses\User object, _(*9)

User results

$response = $ihasco->users->results(mixed $resultId, int $cursor = null);
$allResults = $response->getData();

Returns an array of Ihasco\ClientSDK\Responses\Result objects, _(*10)

Create user

Send data as per api spec, _(*11)

$response = $ihasco->users->create(array $userData);
$oneUser = $response->getData();

Returns a single Ihasco\ClientSDK\Responses\User object, _(*12)

Edit user

Send data as per api spec, _(*13)

$response = $ihasco->users->update(int $userId, array $userData);
$oneUser = $response->getData();

Returns a single Ihasco\ClientSDK\Responses\User object, _(*14)

Delete a user

$response = $users->delete(int $id);

Response Exceptions

Anything other than a 2xx response will result in a Ihasco\ClientSDK\Exceptions\Exception being thrown. Possible exceptions are as follows:, _(*15)

try {
    $response = $ihasco->programmes->all();
} catch(Ihasco\ClientSDK\Exceptions\CannotConnect $e) {
    // Cannot connect to server
} catch(Ihasco\ClientSDK\Exceptions\CannotAuthenticate $e) {
    // Bad API key
} catch(Ihasco\ClientSDK\Exceptions\InvalidResource $e) {
    // Non-existent resource
} catch(Ihasco\ClientSDK\Exceptions\ServerError $e) {
    // Something went wrong on the server
} catch(Ihasco\ClientSDK\Exceptions\BadMethod $e) {
    // Invalid HTTP method
} catch(Ihasco\ClientSDK\Exceptions\ValidationError $e) {
    // Something wrong with your submission
    var_dump($e->getErrors());
} catch(Exception $e) {
    // something else
}

Pagination

$hasPagination = $response->hasPagination(); // boolean

$nextPage = $response->getNextPage(); // Response or null

$prevPage = $response->getPrevPage(); // Response or null