dhl sdk api unified location finder

DPDHL Unified Location Finder API SDK

DPDHLユニファイドロケーションファインダーAPI SDKパッケージは、次のWebサービスへのインターフェイスを提供します。

• ロケーションファインダー - 統一

要件

システム要件

• JSON拡張機能を備えたPHP 8.1+

パッケージ要件

• netresearch/jsonmapper ：JSON応答メッセージのPHPオブジェクトへの敏aserializationのためのマッパー
• php-http/discovery ：HTTPクライアントおよびメッセージ工場の実装のためのディスカバリーサービス
• php-http/httplug ：プラグ可能なHTTPクライアントの抽象化
• php-http/logger-plugin ：httplug用のHTTPクライアントロガープラグイン
• psr/http-client ：PSR-18 HTTPクライアントインターフェイス
• 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 ：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例外がエンドユーザーへの表示に適した人間の読み取り可能なエラーメッセージを保持していることを示します。