yaroslawww/ipro-software-api-php

This package is abandoned and no longer maintained. The author suggests using the think.studio/ipro-software-api-php package instead.

iProSoftware api client (php)

3.1.2 2023-05-29 08:01 UTC

This package is auto-updated.

Last update: 2024-02-08 10:09:00 UTC


README

Packagist License Packagist Version Total Downloads Build Status Code Coverage Scrutinizer Code Quality

Unofficial IproSoftware api implementation.

Installation

You can install the package via composer:

    composer require think.studio/ipro-software-api-php

Simple example

    $iproSoftwareClient = new \IproSoftwareApi\IproSoftwareClient([
        'api_host' => 'my-iprosoftware-api-host',
        'client_id' => 'my-iprosoftware-client-id',
        'client_secret' => 'my-iprosoftware-client-secret',
    ]);
    
    $response = $iproSoftwareClient->getBookingRulesList();

    $responseBody = json_decode($response->getBody());

Note: All predefined api requests name you can find here

Configure the client

The Trello client needs a few configuration settings to operate successfully.

Setting Description
api_host An api domain associated with your application.
client_id The application client ID associated with your application.
client_secret The application client secret associated with your application.
oauth_endpoint You can specify you own oauth endpoint (By default used /oauth/2.0/token).
requests_path_prefix You can specify you own endpoint prefix for all predefined endpoints (By default used /apis).
client_conf Set of predefined configurations applied to http client (By default package use Guzzle, all available options for Guzzle you can find here).
cache_manager By default package not cache the access token and request new one every request. If you want to cache access token to some storage (file, DB, ...) than you should create you own class from interface IproSoftwareApi\Contracts\AccessTokenCacher and pass object to this setting
access_token_class Also you can specify you own access token class implements interface IproSoftwareApi\Contracts\AccessToken

Set configuration when creating client

$iproSoftwareClient = new \IproSoftwareApi\IproSoftwareClient([
    'api_host' => 'my-iprosoftware-api-host',
    'client_id' => 'my-iprosoftware-client-id',
    'client_secret' => 'my-iprosoftware-client-secret',
    'cache_manager' => new MyDatabaseAccessTokenCacheManager(),
    'client_conf' => [
        'timeout' => 15,
        'http_errors' => false,
        'headers' => [
            'Accept' => 'application/json',
        ]
    ]
]);

Set access token cache manager after initialisation

    $iproSoftwareClient = new \IproSoftwareApi\IproSoftwareClient([
        'api_host' => 'my-iprosoftware-api-host',
        'client_id' => 'my-iprosoftware-client-id',
        'client_secret' => 'my-iprosoftware-client-secret'
    ]);
    
    $iproSoftwareClient->setAccessTokenCacheManager(new MyDatabaseAccessTokenCacheManager())

Set your own http client if you want full control over requests

    $iproSoftwareClient = new \IproSoftwareApi\IproSoftwareClient();
    
    $iproSoftwareClient->setHttpClient(new MyOwnHttpClient($credentials))

Handling exceptions

If you try to query with the wrong configuration, you will get an exception IproSoftwareApi\Exceptions\IproSoftwareApiException. If the server fails to get the access token, you will receive IproSoftwareApi\Exceptions\IproSoftwareApiAccessTokenException

    try {
        $response = $iproSoftwareClient->getBookingRulesList();
    } catch (IproSoftwareApi\Exceptions\IproSoftwareApiAccessTokenException $e) {
        $code = $e->getCode(); // Http status code from response
        $reason = $e->getMessage(); // Http status reason phrase
        $httpResponse = $e->getResponse(); // Psr\Http\Message\ResponseInterface from http client
    }

Testing

  composer test

Credits

  • Think Studio