kruegge82 / dhl-php-rest-sdk
Note: This is the specification of the DPDHL Group Parcel DE Shipping API for Post & Parcel Germany. This REST web service allows business customers to create shipping labels on demand.
Requires
- php: ^7.4 || ^8.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.3
- guzzlehttp/psr7: ^1.7 || ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.5
- phpunit/phpunit: ^8.0 || ^9.0
README
Note: This is the specification of the DPDHL Group Parcel DE Shipping API for Post & Parcel Germany. This REST web service allows business customers to create shipping labels on demand.
Installation & Usage
Requirements
PHP 7.4 and later. Should also work with PHP 8.0.
Composer
To install the bindings via Composer, add the following to composer.json
:
{ "repositories": [ { "type": "vcs", "url": "https://github.com/GIT_USER_ID/GIT_REPO_ID.git" } ], "require": { "GIT_USER_ID/GIT_REPO_ID": "*@dev" } }
Then run composer install
Manual Installation
Download the files and include autoload.php
:
<?php require_once('/path/to/OpenAPIClient-php/vendor/autoload.php');
Getting Started
Please follow the installation procedure and then run the following:
<?php require_once(__DIR__ . '/vendor/autoload.php'); $apiInstance = new kruegge82\DHL\Api\GeneralApi( // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`. // This is optional, `GuzzleHttp\Client` will be used as default. new GuzzleHttp\Client() ); try { $result = $apiInstance->rootGet(); print_r($result); } catch (Exception $e) { echo 'Exception when calling GeneralApi->rootGet: ', $e->getMessage(), PHP_EOL; }
API Endpoints
All URIs are relative to https://api-eu.dhl.com/parcel/de/shipping/v2
Class | Method | HTTP request | Description |
---|---|---|---|
GeneralApi | rootGet | GET / | Return API version |
ManifestsApi | getManifests | GET /manifests | Retrieve daily manifest document |
ManifestsApi | manifestsPost | POST /manifests | Mark shipments as being ready for shipping |
ShipmentsAndLabelsApi | createOrders | POST /orders | Create one or more shipments and their documents. (This is the primary call of the API.) |
ShipmentsAndLabelsApi | getLabel | GET /labels | Download PDF document |
ShipmentsAndLabelsApi | getOrder | GET /orders | Retrieve shipment documents - labels and customs documents |
ShipmentsAndLabelsApi | ordersAccountDelete | DELETE /orders | Delete one or more shipments |
Models
- BankAccount
- Commodity
- Consignee
- ContactAddress
- Country
- CustomsDetails
- Dimensions
- Document
- GetManifestData
- LabelDataResponse
- Locker
- MultipleManifestResponse
- POBox
- PostOffice
- RequestStatus
- ResponseItem
- ServiceInformation
- ServiceInformationAmp
- ServiceInformationBackend
- Shipment
- ShipmentDetails
- ShipmentManifestingRequest
- ShipmentOrderRequest
- ShipmentShipper
- Shipper
- ShipperReference
- ShortResponseItem
- SingleManifestResponse
- VAS
- VASCashOnDelivery
- VASDhlRetoure
- VASIdentCheck
- ValidationMessageItem
- Value
- Weight
Authorization
Authentication schemes defined for the API:
BasicAuth
- Type: HTTP basic authentication
ApiKey
- Type: API key
- API key parameter name: dhl-api-key
- Location: HTTP header
OAuth2
- Type:
OAuth
- Flow:
password
- Authorization URL: ``
- Scopes: N/A
Tests
To run the tests, use:
composer install vendor/bin/phpunit
Author
About this package
This PHP package is automatically generated by the OpenAPI Generator project:
- API version:
2.1.12
- Generator version:
7.11.0
- Generator version:
- Build package:
org.openapitools.codegen.languages.PhpClientCodegen