dhl sdk api unified location finder

DPDHL Unified Ort Finder API SDK

Das DPDHL Unified Location Finder API SDK -Paket bietet eine Schnittstelle zu den folgenden Webdiensten:

• Standort Finder - Unified

Anforderungen

Systemanforderungen

• PHP 8.1+ mit JSON -Erweiterung

Paketanforderungen

• netresearch/jsonmapper : Mapper für die Deserialisierung von JSON -Antwortnachrichten in PHP -Objekte
• php-http/discovery : Erkennungsdienst für HTTP-Client- und Message Factory-Implementierungen
• php-http/httplug : Steckbare HTTP-Client-Abstraktion
• php-http/logger-plugin : HTTP-Client-Logger-Plugin für HTTPLUG
• psr/http-client : PSR-18 HTTP-Client-Schnittstellen
• psr/http-factory : PSR-7 HTTP Message Factory-Schnittstellen
• psr/http-message : PSR-7 HTTP-Nachrichtenoberflächen
• psr/log : PSR-3-Logger-Schnittstellen

Virtuelle Paketanforderungen

• psr/http-client-implementation : Jedes Paket, das einen PSR-18-kompatiblen HTTP-Client bietet
• psr/http-factory-implementation : Jedes Paket, das PSR-7-kompatible HTTP-Nachrichtenfabriken bietet
• psr/http-message-implementation : Jedes Paket, das PSR-7-HTTP-Nachrichten bereitstellt

Entwicklungspaketanforderungen

• nyholm/psr7 : PSR-7 HTTP Message Factory & Message Implementierung
• phpunit/phpunit : Tests -Framework
• php-http/mock-client : Httplug Mock Client-Implementierung
• phpstan/phpstan : Statische Analysewerkzeug
• squizlabs/php_codesniffer : Statische Analyse -Tool
• rector/rector : Automatisches Refactoring -Tool, das bei PHP -Upgrades hilft
• fig/log-test : Testen Sie Dienstprogramme für psr/log

Installation

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

Deinstallation

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

Testen

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

Merkmale

Der DPDHL Unified Location Finder API SDK unterstützt die folgenden Funktionen:

• Finden Sie DHL -Servicepunkte zum Senden und Empfangen von Paketen.

Öffentliche API

Die für den Verbrauch geeigneten Komponenten der Bibliothek umfassen

• Service:
  • Servicefabrik
  • Standort Finder Service
• Datenübertragungsobjekte:
  • Servicepunkt Ort mit Adresse, GEO -Koordinaten, Öffnungszeitspezifikationen

Verwendung

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

Fehlerbehandlung

Der SDK wird immer nur Ausnahmen vom Typ DhlSdkUnifiedLocationFinderExceptionServiceException werfen. Unterklassen der ServiceException können verwendet werden, um die Art des aufgetretenen Fehlers zu beschreiben.

A DhlSdkUnifiedLocationFinderExceptionDetailedServiceException zeigt an, dass die Ausnahme eine für die Anzeige für den Endbenutzer geeignete Fehlermeldung enthält.