dhl sdk api unified location finder

DPDHL Unified Location Finder API SDK

Le package SDK API DPDHL Unified Location Finder offre une interface aux services Web suivants:

• Finder de l'emplacement - Unified

Exigences

Exigences du système

• PHP 8.1+ avec extension JSON

Exigences de package

• netresearch/jsonmapper : Mappeur pour la désérialisation des messages de réponse JSON dans des objets PHP
• php-http/discovery : Discovery Service for HTTP Client and Message Factory Implémentations
• php-http/httplug : Abstraction du client HTTP enfichable
• php-http/logger-plugin : HTTP Client Logger Plugin pour HTTPLUG
• psr/http-client : Interfaces client HTTP PSR-18 HTTP
• psr/http-factory : PSR-7 Interfaces d'usine de message HTTP
• psr/http-message : Interfaces de message HTTP PSR-7
• psr/log : interfaces PSR-3 Logger

Exigences de package virtuel

• psr/http-client-implementation : Tout package qui fournit un client HTTP compatible PSR-18
• psr/http-factory-implementation : Tout package qui fournit des usines de messages HTTP compatibles PSR-7
• psr/http-message-implementation : Tout package qui fournit des messages HTTP PSR-7

Exigences du package de développement

• nyholm/psr7 : PSR-7 HTTP Message Factory & Message Implémentation
• phpunit/phpunit : framework de test
• php-http/mock-client : HTTPLUG MOCK Implémentation du client
• phpstan/phpstan : outil d'analyse statique
• squizlabs/php_codesniffer : outil d'analyse statique
• rector/rector : outil de refactorisation automatique pour aider les mises à niveau PHP
• fig/log-test : Test Utilitaires pour psr/log

Installation

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

Désinstallation

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

Essai

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

Caractéristiques

Le SDK API DPDHL Unified Location Finder prend en charge les fonctionnalités suivantes:

• Trouvez des points de service DHL pour l'envoi et la réception des forfaits.

API publique

Les composants de la bibliothèque adaptés à la consommation comprennent

• service:
  • usine de service
  • Service de recherche d'emplacement
• Objets de transfert de données:
  • Emplacement du point de service avec adresse, coordonnées géo, spécifications des heures d'ouverture

Usage

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

Gestion des erreurs

Le SDK lancera uniquement des exceptions de type DhlSdkUnifiedLocationFinderExceptionServiceException . Les sous-classes de ServiceException peuvent être utilisées pour décrire le type d'erreur qui s'est produite.

A DhlSdkUnifiedLocationFinderExceptionDetailedServiceException indique que l'exception contient un message d'erreur lisible par l'homme adapté à l'affichage à l'utilisateur final.