dhl sdk api unified location finder

DPDHL Localização unificada Finder API SDK

O pacote API SDK DPDHL Unified Location Finder API oferece uma interface para os seguintes serviços da Web:

• Localizador de localização - unificado

Requisitos

Requisitos do sistema

• Php 8.1+ com extensão JSON

Requisitos de pacote

• netresearch/jsonmapper : mapeador para deserialização de mensagens de resposta JSON em objetos PHP
• php-http/discovery : Serviço de Discovery para implementações de cliente e fábrica de mensagens HTTP
• php-http/httplug : abstração http http giratória
• php-http/logger-plugin : http client logger plugin para httplug
• psr/http-client : PSR-18 HTTP Client Interfaces
• psr/http-factory : PSR-7 HTTP Message Factory Interfaces
• psr/http-message : interfaces de mensagem HTTP PSR-7
• psr/log : Interfaces de Logger PSR-3

Requisitos de pacote virtual

• psr/http-client-implementation : Qualquer pacote que forneça um cliente HTTP compatível com PSR-18
• psr/http-factory-implementation : Qualquer pacote que forneça fábricas de mensagens HTTP compatíveis com PSR-7
• psr/http-message-implementation : Qualquer pacote que forneça mensagens PSR-7 HTTP

Requisitos de pacote de desenvolvimento

• nyholm/psr7 : PSR-7 HTTP Message Factory & Message Implementation
• phpunit/phpunit : estrutura de teste
• php-http/mock-client : implementação do cliente simulado httplug
• phpstan/phpstan : ferramenta de análise estática
• squizlabs/php_codesniffer : ferramenta de análise estática
• rector/rector : Ferramenta de refatoração automática para ajudar com atualizações de PHP
• fig/log-test : Utilitários de teste para psr/log

Instalação

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

Desinstalação

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

Teste

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

Características

O DPDHL Unified Location Finder API SDK suporta os seguintes recursos:

• Encontre pontos de serviço DHL para enviar e receber pacotes.

API pública

Os componentes da biblioteca adequados para consumo compreendem

• serviço:
  • Fábrica de serviços
  • Serviço de localização de localização
• Objetos de transferência de dados:
  • Localização do ponto de serviço com endereço, coordenadas geográficas, especificações de horário de funcionamento

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
}

Manuseio de erros

O SDK só lançará exceções do tipo DhlSdkUnifiedLocationFinderExceptionServiceException . As subclasses da ServiceException podem ser usadas para descrever o tipo de erro que ocorreu.

A DhlSdkUnifiedLocationFinderExceptionDetailedServiceException indica que a exceção contém uma mensagem de erro legível por humanos adequada para exibição ao usuário final.