dhl sdk api unified location finder

DPDHL Ubicación unificada Finder API SDK

El paquete DPDHL Unified Ubication Finder API SDK ofrece una interfaz a los siguientes servicios web:

• Buscador de ubicación - Unificado

Requisitos

Requisitos del sistema

• PHP 8.1+ con extensión JSON

Requisitos de paquete

• netresearch/jsonmapper : Mapper para la deserialización de los mensajes de respuesta JSON en objetos PHP
• php-http/discovery : Servicio de descubrimiento para implementaciones de fábrica de clientes y fábrica de mensajes HTTP
• php-http/httplug : abstracción del cliente http enchufable
• php-http/logger-plugin : HTTP Cliente Logger Plugin para httplug
• psr/http-client : interfaces del cliente PSR-18 HTTP
• psr/http-factory : PSR-7 HTTP Mensajes Interfaces
• psr/http-message : interfaces de mensajes HTTP PSR-7
• psr/log : interfaces PSR-3 Logger

Requisitos de paquete virtual

• psr/http-client-implementation : cualquier paquete que proporcione un cliente HTTP compatible con PSR-18
• psr/http-factory-implementation : cualquier paquete que proporcione fábricas de mensajes HTTP compatibles con PSR-7
• psr/http-message-implementation : cualquier paquete que proporcione mensajes HTTP PSR-7

Requisitos del paquete de desarrollo

• nyholm/psr7 : PSR-7 HTTP Mensajes Factory e Implementación de mensajes
• phpunit/phpunit : marco de prueba
• php-http/mock-client : httplug simulando implementación del cliente
• phpstan/phpstan : Herramienta de análisis estático
• squizlabs/php_codesniffer : herramienta de análisis estático
• rector/rector : herramienta de refactorización automática para ayudar con las actualizaciones de PHP
• fig/log-test : Test Utilidades para psr/log

Instalación

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

Desinstalación

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

Pruebas

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

Características

El DPDHL Unified Ubication Finder API SDK admite las siguientes características:

• Encuentre puntos de servicio DHL para enviar y recibir paquetes.

API pública

Los componentes de la biblioteca adecuados para el consumo comprenden

• servicio:
  • fábrica de servicios
  • Servicio de buscadores de ubicación
• Objetos de transferencia de datos:
  • Ubicación del punto de servicio con dirección, coordenadas GEO, especificaciones de horas de apertura

Uso

 $ 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
}

Manejo de errores

El SDK solo arrojará excepciones de tipo DhlSdkUnifiedLocationFinderExceptionServiceException . Se pueden usar subclases de ServiceException para describir el tipo de error que ocurrió.

A DhlSdkUnifiedLocationFinderExceptionDetailedServiceException indica que la excepción contiene un mensaje de error legible por humanos adecuado para visualizar al usuario final.