nebbia-fitness/dhl-express-php-sdk

0.2.1 2020-11-09 11:05 UTC

This package is auto-updated.

Last update: 2024-09-09 19:49:24 UTC


README

这个非官方库封装了DHL Express JSON/REST API(称为MyDHL_API)的一些功能。

要获取标准DHL的SDK,请查看Petschko提供的优秀SDK,这是我受启发的。

要求

  • DHL Express技术联系人提供的测试(和实时)凭据
  • PHP版本5.5或更高 (它可能在旧版本上运行,但我不会为这些版本提供支持)
  • 已安装Guzzle

兼容性

该项目是为MyDHL API v1编写的。

安装

您可以使用Composer将包安装到您的项目中

composer require nebbia-fitness/dhl-express-php-sdk

支持的API操作

使用方法

查看示例以获取基本示例和生成测试标签的脚本(见下文)

请求访问实时API

为了获取实时账户的凭据,DHL要求测试某些场景的测试标签

测试脚本可以在示例文件夹中找到

  1. 国内运输,周六送货 - test_1.php
  2. 国内运输时间选项和2个包裹 - test_2.php
  3. 国际运输,不承担关税 - test_3.php
  4. 国际运输,承担关税 - test_4.php
  5. 国际运输,承担关税,服务DDP - test_5.php
  6. 国际运输,承担关税,不同的支付账户 - test_6.php

在测试API过程中学到的知识

  • 即使是国家包裹,“InternationalDetail”部分也是必需的
  • 地址中的街道名称和街道编号目前没有任何影响,始终使用“StreetLines”字段
  • 收件人地址中的公司名称是包裹上的名称(第一行)
  • 包装尺寸是必需的,但不必非常准确(DHL仍会检查它们) - 因此,可以始终使用您拥有的最小包装尺寸
  • “StreetLine”不能用于任何额外的名称 - 使用“StreetLines2”进行此操作 - 总是用于街道名称和编号

更多信息将很快提供。此包是WIP。