sspat/profiru

Profi.ru partership program API connector

Profi.ru partership program API client

, _(*1)

Features

This package provides easy access to the Profi.ru partnership program API., _(*2)

After registering on the program and receiving your SSL certificate and key you can use the API right away., _(*3)

Currently implemented in the package are the dictionary and pagination API's. The provisioning API will be implemented in future releases., _(*4)

Requirements

• The minimum required PHP version is PHP 7.3.0.
• You will need an SSL certificate and public key provided by the Profi.ru partnership program representatives to get access to the API

Installation

The preferred way to install this extension is through composer., _(*5)

Either run, _(*6)

composer require sspat/profiru

or add, _(*7)

"sspat/profiru": "*"

to the require section of your composer.json file., _(*8)

Usage

Sending requests to the API, _(*9)

use GuzzleHttp\RequestOptions;
use Http\Adapter\Guzzle6\Client as GuzzleAdapter;
use sspat\ProfiRu\Client;
use sspat\ProfiRu\Constants\Domains;

// Create an instance of any PSR-18 compliant HTTP Client and pass your partnership SSL certificate and key paths
$httpClient = GuzzleAdapter::createWithConfig([
    RequestOptions::TIMEOUT => 5,
    RequestOptions::SSL_KEY => 'partner.key',
    RequestOptions::CERT => 'partner.crt',
    RequestOptions::VERIFY => false,
]);
// Create an instance of the API client, passing the HTTP client to it
$api = new Client($httpClient);

// Get Locations dictionary
$locations = $api->getLocations();
// Get Services dictionary
$services = $api->getServices();

// For requests to the pagination API an API domain must be specified
$organizations = $api->getOrganizations(Domains::HEALTHCARE);
$specialists = $api->getSpecialists(Domains::BEAUTY);

Requests to the pagination API require choosing an API domain and can be further configured with a second argument., _(*10)

$organizations = $api->getOrganizations(
    Domains::HEALTHCARE,
    [
         'city'   => Cities::MOSCOW,
         'from'   => 220,
         'count'  => 10,
         'scope'  => Scopes::SCOPE_FULL,
         'ip'     => '144.135.23.1',
         'models' => [
             Models::ASSOCIATION,
             Models::ASSOCIATION_STRUCTURE_UNIT
         ]
    ]
);

Supported domains for the pagination API, _(*11)

Supported additional parameters for the pagination API, _(*12)

Getting the response

The client returns response objects that already contain the API response in form of an array. You can also retrieve the PSR-7 response object if you need additional response data., _(*13)

// Get Locations dictionary
$locations = $api->getLocations();
// Get response body as Array
$locationsArray = $locations->asArray();
// Get PSR-7 response object
$psrResponse = $locations->response();
var_dump((string) $psrResponse->getBody());

Handling errors

The response object processes all errors returned by the API and raises them in form of an exception., _(*14)

use sspat\ProfiRu\Exceptions\ErrorResponse;

try {
    $services = $api->getServices();
} catch (ErrorResponse $e) {
    var_dump($e->getErrors());
}