dhl sdk api unified location finder

DPDHL統一位置查找器API SDK

DPDHL統一位置查找器API SDK軟件包提供以下Web服務的接口：

• 位置查找器 - 統一

要求

系統要求

• php 8.1+帶JSON擴展

包裝要求

• netresearch/jsonmapper ：用於將JSON響應消息的映射到PHP對象
• php-http/discovery ：HTTP客戶端的發現服務和消息工廠實現
• php-http/httplug ：可插拔的HTTP客戶抽象
• php-http/logger-plugin ：httplug的http客戶端logger插件
• psr/http-client ：PSR-18 HTTP客戶端接口
• psr/http-factory 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 ：提供PSR-7 HTTP消息的任何軟件包

開發包要求

• nyholm/psr7 ：PSR-7 HTTP消息工廠和消息實現
• phpunit/phpunit ：測試框架
• php-http/mock-client ：httplug模擬客戶端實現
• phpstan/phpstan ：靜態分析工具
• squizlabs/php_codesniffer ：靜態分析工具
• rector/rector ：自動重構工具可幫助PHP升級
• fig/log-test ： psr/log的測試實用程序

安裝

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

解除安裝

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

測試

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

特徵

DPDHL統一位置查找器API SDK支持以下功能：

• 查找用於發送和接收軟件包的DHL服務點。

公共API

圖書館的組件適合消費

• 服務：
  • 服務工廠
  • 位置查找器服務
• 數據傳輸對象：
  • 服務點位置，地址，地理坐標，開放時間規格

用法

 $ 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表明該異常包含一個適合顯示給最終用戶的人類可讀錯誤消息。