dhl sdk api unified location finder

DPDHL Unified Location Finder API SDK

DPDHL Unified Location Finder API API SDK предлагает интерфейс для следующих веб -сервисов:

• Finder местоположения - унифицированный

Требования

Системные требования

• PHP 8.1+ с расширением JSON

Требования к упаковке

• netresearch/jsonmapper : Mapper для детериализации сообщений ответов JSON в объекты PHP
• php-http/discovery : служба Discovery для реализаций HTTP Client и Message Factory
• php-http/httplug : подключаемая http client Abstraction
• php-http/logger-plugin : плагин HTTP Client Logger для Httplug
• psr/http-client : PSR-18 HTTP Client Interfaces
• psr/http-factory : PSR-7 HTTP
• psr/http-message : PSR-7 HTTP-интерфейсы
• psr/log : PSR-3 Интерфейсы регистрации

Требования к виртуальному пакету

• psr/http-client-implementation : любой пакет, который предоставляет PSR-18 совместимый с HTTP-клиентом
• psr/http-factory-implementation : любой пакет, который предоставляет PSR-7, совместимые с HTTP-заводами
• psr/http-message-implementation : любой пакет, который предоставляет HTTP-сообщения PSR-7

Требования к пакетам разработки

• nyholm/psr7 : PSR-7 HTTP-завод и реализация сообщений
• phpunit/phpunit : структура тестирования
• php-http/mock-client : httplug Mock Celiveration Client
• phpstan/phpstan : Статический инструмент анализа
• squizlabs/php_codesniffer : инструмент статического анализа
• rector/rector : инструмент автоматического рефакторинга, чтобы помочь с обновлениями PHP
• psr/log fig/log-test

Установка

$ composer require dhl/sdk-api-unified-location-finder

Удаление

$ composer remove dhl/sdk-api-unified-location-finder

Тестирование

$ ./vendor/bin/phpunit -c test/phpunit.xml

Функции

DPDHL Unified Location Finder API SDK поддерживает следующие функции:

• Найдите точки службы DHL для отправки и получения пакетов.

Общественный API

Компоненты библиотеки, подходящие для потребления, включают

• услуга:
  • Сервисная фабрика
  • Местоположение Service
• Объекты передачи данных:
  • Местоположение точки обслуживания с адресом, координаты GEO, спецификации часов открытия

Использование

 $ consumerKey = ' Your application consumer key ' ;
$ logger = new  Psr  Log  NullLogger ();

$ serviceFactory = new  Dhl  Sdk  UnifiedLocationFinder  Service  ServiceFactory ();
$ service = $ serviceFactory -> createLocationFinderService ( $ consumerKey , $ logger );

try {
    /** @var DhlSdkUnifiedLocationFinderApiDataLocationInterface $locations  */
    $ locations = $ service -> getPickUpLocations (
        $ countryCode = ' DE ' ,
        $ postalCode = ' 04129 ' ,
        $ city = ' Leipzig ' ,
        $ street = ' Nonnenstraße 11d ' ,
        $ service = ' parcel-eu ' ,
        $ radius = 2000 ,
        $ limit = 25
    );
} catch (  Dhl  Sdk  UnifiedLocationFinder  Exception  ServiceException $ e ) {
    // handle errors
}

Обработка ошибок

SDK только когда -либо бросает исключения типа DhlSdkUnifiedLocationFinderExceptionServiceException . Подклассы ServiceException могут использоваться для описания вида ошибок, которая произошла.

A DhlSdkUnifiedLocationFinderExceptionDetailedServiceException указывает, что исключение содержит сообщение об ошибке, читаемое на человеке, подходящее для отображения для конечного пользователя.