apiship/apidq-client-php

PHP client for ApiDQ API

v1.0.1 2023-11-08 09:52 UTC

This package is auto-updated.

Last update: 2024-11-13 06:22:03 UTC


README

ApiDQ API PHP Client

Latest Stable Version Total Downloads Latest Unstable Version License PHP Version Require codecov

This is the PHP ApiDQ API client. This library allows using of the actual API version. You can find more info in the documentation.

Installation

Follow those steps to install the library:

  1. Download and install Composer package manager.
  2. Install the library from the Packagist by executing this command:
composer require apiship/apidq-client-php:"~1.0"

Note: API client uses php-http/client-implementation as a PSR-18, PSR-17 implementation. You can replace those implementations during installation by installing this library with the implementation of your choice, like this:

composer require symfony/http-client guzzlehttp/psr7 apiship/apidq-client-php:"~1.0"

Usage

Firstly, you should initialize the Client. The easiest way to do this is to use the SimpleClientFactory:

$client = \ApiDQ\Factory\SimpleClientFactory::createClient('https://api.apidq.io', 'apiKey');
$client = \ApiDQ\Factory\SimpleClientFactory::createClientWithCache('https://api.apidq.io', 'apiKey', $psrCache);
$client = \ApiDQ\Factory\SimpleClientFactory::createClientWithFileCache('https://api.apidq.io', 'apiKey', sys_get_temp_dir());

The client is separated into several resource groups, all of which are accessible through the Client's public properties. You can call API methods from those groups like this:

$cleanResponse = $client->address->clean(
    (new \ApiDQ\Model\Service\Address\CleanRequest())
        ->setQuery('Москва')
        ->setCountryCode('RU')
);

To handle errors you must use two types of exceptions:

  • ApiDQ\Exception\Service\ServiceException for the api service error.
  • ApiDQ\Exception\Client\BuilderException for the client builder error.