1. 介绍
1.1 简介
本文档主要针对使用Shipment Tracking API的用户进行说明。
- 使用Shipment Tracking API的用户可以实现以下需求:
a.检索装运的跟踪信息。
b. 确定参与装运的Deutsche Post DHL(DPDHL)服务提供商。
c. 验证DPDHL是否使用正确的送货地址。这可以减少误发货的数量
如想了解这个API的更多详情,请参见该网站详细说明。
2. 注册流程
2.1 注册/登录
- 登录/注册网址: https://developer.dhl.com/user/login?destination=/node/3
- 首次使用需注册,点击右侧的“Sign up here”按钮;
- 已注册用户输入用户名和密码后,点击“Log in”;
如已注册用户忘记密码,点击“Forgot your password?”,并进行找回密码操作;
新用户进入注册页面后,填写姓名、Email、Company Name等相关信息进行注册,填写完所有信息并进行CAPTCHA验证后,点击“Send”发送注册信息;
- 新用户注册成功后,将跳转到以下界面,同时注册邮箱将收到DHL API Developer Portal发出的邮件通知。请参照邮件内容进行账号密码设置;
- 密码要求:
- 长度至少8位;
- 至少包含三种类型:大写字母、小写字母、数字、特殊字符(如:& $ @)
2.2 获取API密钥
方法一:新用户注册完成登录后,点击“Apps”
方法二:登录用户后,进入网址https://developer.dhl.com/api-reference/shipment-tracking#get-started-section/,在“User Guide”/“Get Access”页面中点击“My Apps”,如下图;
在APPS页面点击“+Create App” 按钮;
- 如下图,在创建APP页面填写信息
- 填写APP Name和Description(均必填);
- ”API’s name”:在下拉菜单中选择“Shipment Tracking – Unified”;
- “Environment”默认选择Production,不为客户提供测试环境;
- “Rate Limit”默认250 requests every 1 day,如需增加,请在APP创建完成后再提交申请,具体步骤请参见2.3。
- 以上信息填写完成后,点击”Add to app”下“+”按钮,将其添加到Selected APIs;
点击”Create APP”,完成创建。
- 创建成功后,App Status为“in progress”状态;
点击已创建的App name,进入详情页面查看获取API Key&Secret,如下图;
- 审核通过后,系统会将发送审核通过邮件到注册邮箱地址,APP Status更新为”approved”;
点击如下图中APP名称,进入详情页面;
在详情页面中,点击“Show Key”可查看API Key和API Secret;
2.3 升级访问次数
点击”Upgrade Rate Limit”,进入申请页面;
- 填写申请表单
“From which DHL division(s) do you want to track shipments?”选中所有DHL服务,即除了”I don’t know”外的所有选项;
其余内容按需求填写,填写完成后点击”Send Message”.
- 提交成功后,请注意查收support@dpdhl.freshdesk.com发出的邮件,1-2个工作日内将收到审核结果的通知。
3. Shipment Tracking API 对接指导
请登录该网址:https://developer.dhl.com/api-reference/shipment-tracking#get-started-section/查看Tracking API具体说明。
API Environment:https://api-eu.dhl.com/track
Description:Production