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 ：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表明该异常包含一个适合显示给最终用户的人类可读错误消息。